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What will you learn from this book? 

If you have an idea for a killer Android app, this book will help you 
build your first working application in a jiffy. You'll learn hands-on how 
to structure your app, design interfaces, create a database, make your 
app work on various smartphones and tablets, and much more. It’s like 
having an experienced Android developer sitting right next to you! All 
you need is some Java know-how to get started. 
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Why does this book look so different? 

Based on the latest research in cognitive science and learning theory, Head First 
Android Development uses a visually rich format to engage your mind, rather 
than a text-heavy approach that puts you to sleep. Why waste your time 
struggling with new concepts? This multi-sensory learning experience is 
designed for the way your brain really works. 



“A comprehensive 
beginner's guide to 
Android development, 
easy to read and full of 
excellent examples and 
exercises.” 

— Edward Yue Shung Wong 
( @arkangelojkaos) 

“This is, without a 
doubt, the best available 
book for learning 
Android development. 

If you can get only one, 
make it this one.” 

— Kenneth Kousen 
President , Kousen IT Inc., 
and JavaOne Rock Star 

“Become an able Android 
developer applying up- 
to-date patterns and 
create that next killer 
app. Head First Android 
Development will be your 
friendly, accurate, and 
fun-to-be-with master 
craftsman on that path. ” 

— Ingo Krotzky 
Android Learner 
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f apps that was easier to understand 
V than the space shuttle flight manual? I 
guess it's just a fantasy... 
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getting started 

Diving In 

Android has been taking the world by storm. 

Everybody wants a smart phone or tablet, and Android devices are hugely popular. In 
this book we’ll teach you how to develop your own apps, and we’ll start by getting 
you to build a basic app and run it on an Android Virtual Device. Along the way you’ll 
meet some of the basic components of all Android apps such as activities and layouts. 

All you need is a little Java know-how... 
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building interactive apps 

Apps That Do Something 





BeerExpert 



Most apps need to respond to the user in some way. 

In this chapter you’ll see how you can make your apps a bit more interactive. You’ll see 
how you can get your app to do something in response to the user, and how to get 
your activity and layout talking to each other like best buddies. Along the way we ll 
take you a bit deeper into how Android actually works by introducing you to R, the 
hidden gem that glues everything together. 

You’re going to build a Beer Adviser app 40 

Create the project 42 

We’ve created a default activity and layout 43 
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multiple activities and Intents 

State Your Intent 



o 



Most apps need more than one activity. 

So far we’ve just looked at single-activity apps, which is fine for simple apps. But when 
things get more complicated, just having the one activity won’t cut it. We’re going to 
show you how to build apps with multiple activities, and how you can get your apps 
talking to each other using intents. We’ll also look at how you can use intents to go 
beyond the boundaries of your app and make activities in other apps on your 
device perform actions. Things just got a whole lot more powerful... 

Apps can contain more than one activity 74 

Here’s the app structure 75 

Create the project 75 

Create the second activity and layout 78 

Welcome to the Android manifest file 80 

Use an intent to start the second activity 83 
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onCreate() 
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- onStart() 
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-► onStop() ■ 
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onDestroy() 



the ctetWhy Recycle 

Do one thing and do it well 

Activities form the foundation of every Android app. 

So far you’ve seen how to create activities, and made one activity start another 
using an intent. But what’s really going on beneath the hood? In this chapter 
we’re going to dig a little deeper into the activity lifecycle. What happens when 
an activity is created and destroyed ? Which methods get called when an activity 
is made visible and appears in the foreground , and which get called when the 
activity loses the focus and is hidden ? And how do you save and restore your 
activity’s state? 
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Enjoy the View 

Let’s face it, you need to know how to create great layouts. 

If you’re building apps you want people to use, you need to make sure they look just 
the way you want. So far we’ve only scratched the surface when it comes to creating 
layouts, so it’s time to look a little deeper. We’ll introduce you to more types of layout 
you can use, and we’ll also take you on a tour of the main GUI components and how 
you use them. By the end of the chapter you’ll see that even though they all look a little 
different, all layouts and GUI components have more in common than you might 
think. 
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Three key layouts: relative, linear, and grid 
Positioning views relative to the parent layout 
Positioning views relative to other views 
Attributes for positioning views relative to other views 
RelativeLayout: a summary 
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Let’s change up a basic linear layout 

Adding weight to one view 

Adding weight to multiple views 
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The full linear layout code 

LinearLayout: a summary 

GridLayout displays views in a grid 

Adding views to the grid layout 

Let’s create a new grid layout 

Row 0: add views to specific rows and columns 

Row 1 : make a view span multiple columns 
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The full code for the grid layout 

GridLayout: a summary 
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list Views and adapters 

Getting Organized 

Want to know how best to structure your Android app? 

You’ve learned about some of the basic building blocks that are used to build apps, 
and now it’s time to get organized . In this chapter we’ll show you how you can take 
a bunch of ideas and structure them into an awesome app. We’ll show you how 
lists of data can form the core part of your app design, and how linking them 
together can create a powerful and easy-to-use app. Along the way, you’ll get your 
first glimpse of using event listeners and adapters to make your app more dynamic. 
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Every app starts with ideas 

Categorize your ideas: top-level, category, and detail/ edit activities 

Navigating through the activities 

Use ListViews to navigate to data 

We’re going to build the Starbuzz app 

The drink detail activity 

The Starbuzz app structure 

The top-level layout contains an image and a list 

The full top-level layout code 

Get ListViews to respond to clicks with a Listener 

The full TopLevelActivity code 

How to create a list activity 

Connect list views to arrays with an array adapter 

Add the array adapter to DrinkCategoryActivity 

What happens when you run the code 

How we handled clicks in TopLevelActivity 

The full DrinkCategoryActivity code 

A detail activity displays data for a single record 

Update the views with the data 

The DrinkActivity code 

Test drive the app 

Your Android Toolbox 
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fragments 

Make it Modular 

You’ve seen how to create apps that work in the same way 
irrespective of the device they’re running on. 

But what if you want your app to look and behave differently depending on whether it’s 
running on a phone or a tablet ? In this chapter we’ll show you how to make your app 
choose the most appropriate layout for the device screen size. We ll also introduce 
you to fragments, a way of creating modular code components that can be reused by 
different activities. 
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nested fragments 

Dealing with Children 

You’ve seen how using fragments in activities allow you 
to reuse code and make your apps more flexible. 

In this chapter we’re going to show you how to nest one fragment inside another. 
You’ll see how to use the child fragment manager to tame unruly fragment 
transactions. Along the way you’ll see why knowing the differences between 
activities and fragments is so important. 
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The StopwatchFragment code 
The StopwatchFragment layout 
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Nested fragments need nested transactions 
The full WorkoutDetailFragment code 
Test drive the app 

Why does the app crash if you press a button? 

Let’s look at the StopwatchFragment layout code 
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Test drive the app 
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action Lars 

Taking Shortcuts 

Everybody likes a shortcut. 

And in this chapter you’ll see how to add shortcuts to your apps using action bars. 
We’ll show you how to start other activities by adding action items to your action bar, 
how to share content with other apps using the share action provider, and how to 
navigate up your app’s hierarchy by implementing the action bar’s Up button. Along 
the way you’ll see how to give your app a consistant look and feel using themes, and 
introduce you to the Android support library package. 
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Great apps have a clear structure 

Different types of navigation 

Let’s start with the action bar 

The Android support libraries 

Your project may include support libraries 
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navigation drawers 

Going Places 

Apps are so much better when they’re easy to navigate. 

In this chapter we’re going to introduce you to the navigation drawer, a slide-out 
panel that appears when you swipe the screen with your finger or click an icon on 
the action bar. We’ll show you how to use it to display a list of links that take you to 
all the major hubs of your app. You’ll also see how switching fragments makes 
those hubs easy to get to and fast to display. 
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SQLite dcttabctses 

Fire up the Database 



SQLite database 



If you’re recording high scores or saving tweets, your app 
will need to Store data. And on Android you usually keep your data safe inside 
a SQLite database. In this chapter, well show you how to create a database , add 
tables to it, and prepopulate it with data, all with the help of the friendly SQLite helper. 
You’ll then see how you can cleanly roll out upgrades to your database structure, and 
how to downgrade it if you need to pull any changes. 

Back to Starbuzz 438 

Android uses SQLite databases to persist data 439 

Android comes with SQLite classes 440 

The current Starbuzz app structure 44 1 

The SQLite helper manages your database 443 

The SQLite helper 443 

Create the SQLite helper 444 
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cursors and as/nctasks 

Connecting to Databases 

So how do you connect your app to a SQLite database? 

So far you’ve seen how to create a SQLite database using a SQLite helper. The 
next step is to get your activities to access it. In this chapter you’ll find out how to 
use cursors to get data from the database, how to navigate cursors and how to 
get data from them. You’ll then find out how to use cursor adapters to connect 
them to list views. Finally, you’ll see how writing efficient multi-threaded code with 
AsyncTasks will keep your app speedy. 

The current DrinkActivity code 474 

Specifying table and columns 478 

Applying multiple conditions to your query 479 

Using SQL functions in queries 481 

Navigating cursors 488 

The DrinkActivity code 490 
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At Your Service 

There are some operations you want to keep on running, 
irrespective of which app has the focus. 

As an example, If you start playing a music file in a music app, you’d probably expect it 
to keep on playing when you switch to another app. In this chapter you’ll see how to use 



services to deal with situations just like this. Along the way you’ll see how use some 
of Android’s built-in services. You’ll see how to to keep your users informed with the 
notification service, and how the location service can tell you where you’re located. 
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How you use the notification service 

Getting your notification to start an activity 

Send the notification using the notification service 

The full code for DelayedMessageService.java 

The steps needed to create the Odometer Service 

Define the Binder 
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material design 

Living in a Material World 

With API level 21, Google introduced Material Design. 

In this chapter we’ll look at what Material Design is, and how to make your apps fit in 
with it. We’ll start by introducing you to card views you can reuse across your app for a 
consistent look and feel. Then we’ll introduce you to the recycler view, the list view’s 
flexible friend. Along the way you’ll see how to create your own adapters, and how to 
completely change the look of a recycler view with just two lines of code. 
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Welcome to Material Design 

The Pizza app structure 

Create the CardView 

The full card__captioned__image.xml code 

Create the basic adapter 

Define the adapter’s ViewHolder 

Create the ViewHolders 

Each card view displays an image and a caption 

Add the data to the card views 

The full code for CaptionedlmagesAdapter.java 

Create the recycler view 

Add the RecyclerView to the layout 

The PizzaMaterialFragment.java code 

A RecyclerView uses a layout manager to arrange its views 

Specifying the layout manager 

The full PizzaMaterialFragment.java code 

Get Main Activity to use the new PizzaMaterialFragment 

What happens when the code runs 

Create PizzaDetailActivity 

What PizzaDetailActivityjava needs to do 

The code for PizzaDetailActivityjava 

Getting a RecyclerView to respond to clicks 

Add the interface to the adapter 

Implement the listener in PizzaMaterialFragment.java 

Bring the content forward 

The full code for fragment_top.xml 

The full code for TopFragment.java 
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The Android Runtime 

Android apps need to run on devices with low powered 
processors and very little memory. 

Java apps can take up a lot of memory and because they run inside their own Java 
Virtual Machine (JVM), Java apps can take a long time to start when they’re running 
on low-powered machines. Android deals with this by not using the JVM for its apps. 
Instead it uses a very different virtual machine called the Android Runtime (ART). In 
this appendix we’ll look at how ART gets your Java apps to run well on a small, low- 
powered device. 
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The Android Debug Bridge 

In this book we’ve focused on using an IDE for all your 
Android needs. But there are times when using a command line tool can be plain 
useful, like those times when Android Studio can’t see your Android device but you just 
know it’s there. In this chapter we’ll introduce you to the Android Debug Bridge (or adb), 
a command line tool you can use to communicate with the emulator or Android devices. 
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the emulator 

The Android Emulator 
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Ever felt like you were spending all your time waiting for the 
emulator? 

There’s no doubt that using the Android emulator is useful. It allows you to see how 
your app will run on devices other than the physical ones you have access to. But 
at times it can feel a little... sluggish. In this appendix we’re going to explain why 
the emulator can seem slow, Even better, we’ll give you a few tips we’ve learned for 

speeding it up. 
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The Top Ten Things (we didn’t cover) 




Even after all that, there’s still a little more. 

There are just a few more things we think you need to know. We wouldn’t feel right 
about ignoring them, and we really wanted to give you a book you’d be able to lift 
without extensive training at the local gym. Before you put down the book, read 
through these tidbits. 
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1 . Distributing your app 

2. Content providers 

3. The Web View class 

4. Animation 

5. Maps 

6. Cursor loaders 

7. Broadcast receivers 

8. App widgets 

9. NinePatch graphics 

10. Testing 
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how to use this book 



Who is this book for? 



If you can answer “yes” to all of these: 



o 

o 

o 



Do you already know how to program in Java? 



Do you want to master Android app development, create 
the next big thing in software, make a small fortune, and 
retire to your own private island? ^ - 

Do you prefer actually doing things and applying the stuff 
you learn over listening to someone in a lecture rattle on 
for hours on end? 



maybe that s 3 

- -far-fetched- Bwt, Y ow 
start somewhere, ri$Wt? 



this book is for you. 



Who should probably back away from this book? 

If you can answer “yes” to any of these: 



o 

o 



Are you looking for a quick introduction or reference book 
to developing Android apps? 

Would you rather have your toenails pulled out by 15 
screaming monkeys than learn something new? Do 
you believe an Android book should cover everything , 
especially all the obscure stuff you’ll never use, and if it 
bores the reader to tears in the process, then so much 
the better? 



this book is not for you. 



CHoic -from Market^ -this book 

is tor anyone with a credit card 
well accept PayPal, tooJ 
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We know what you're thinking 



“How can this be a serious book on developing Android apps?” 

“What’s with all the graphics?” 

“Gan I actually learn it this way?” 

We know what your brain is thinking 

Your brain craves novelty. It’s always searching, scanning, waiting for something 
unusual. It was built that way, and it helps you stay alive. 

So what does your brain do with all the routine, ordinary, normal things 
you encounter? Everything it can to stop them from interfering with the 
brain’s real job — recording things that matter. It doesn’t bother saving the 
boring things; they never make it past the “this is obviously not important' 
filter. 

How does your brain know what’s important? Suppose you’re out for a day 
hike and a tiger jumps in front of you — what happens inside your head and 
body? 

Neurons fire. Emotions crank up. Chemicals surge. 

And that’s how your brain knows . . . 

This must be important! Don’t forget it! 

But imagine you’re at home or in a library. It’s a safe, warm, tiger-free zone. 
You’re studying. Getting ready for an exam. Or trying to learn some tough 
technical topic your boss thinks will take a week, ten days at the most. 

Just one problem. Your brain’s trying to do you a big favor. It’s trying to make 
sure that this obviously unimportant content doesn’t clutter up scarce resources. 
Resources that are better spent storing the really big things. Like tigers. 

Like the danger of fire. Like how you should never have posted those 
party photos on your Lacebook page. And there’s no simple way 
to tell your brain, “Hey brain, thank you very much, but no matter 
how dull this book is, and how little I’m registering on the emotional 
Richter scale right now, I really do want you to keep this stuff around.” 



THl£ thinks 
l£ ,s 
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Metacognition: thinking about thinking 

If you really want to learn, and you want to learn more quickly and more 
deeply, pay attention to how you pay attention. Think about how you think. 

Learn how you learn. 

Most of us did not take courses on metacognition or learning theory when we 
were growing up. We were expected to learn, but rarely taught to learn. 

But we assume that if you’re holding this book, you really want to learn how 
to develop Android apps. And you probably don’t want to spend a lot of time. 

If you want to use what you read in this book, you need to remember what you 
read. And for that, you’ve got to understand it. To get the most from this book, or 
any book or learning experience, take responsibility for your brain. Your brain 
on this content. 

The trick is to get your brain to see the new material you’re learning as 
Really Important. Crucial to your well-being. As important as a tiger. 

Otherwise, you’re in for a constant battle, with your brain doing its best to 
keep the new content from sticking. 

So just how DO you get your brain to treat 
programming like it was a hungry tiger? 

There’s the slow, tedious way, or the faster, more effective way. The 
slow way is about sheer repetition. You obviously know that you are able to learn 
and remember even the dullest of topics if you keep pounding the same thing into your 
brain. With enough repetition, your brain says, “This doesn’t feel important to him, but he 
keeps looking at the same thing over and over and over , so I suppose it must be.” 

The faster way is to do anything that increases brain activity , especially different 
types of brain activity. The things on the previous page are a big part of the solution, 
and they’re all things that have been proven to help your brain work in your favor. For 
example, studies show that putting words within the pictures they describe (as opposed to 
somewhere else in the page, like a caption or in the body text) causes your brain to try to 
makes sense of how the words and picture relate, and this causes more neurons to fire. 
More neurons firing = more chances for your brain to get that this is something worth 
paying attention to, and possibly recording. 

A conversational style helps because people tend to pay more attention when they 
perceive that they’re in a conversation, since they’re expected to follow along and hold up 
their end. The amazing thing is, your brain doesn’t necessarily care that the “conversation” 
is between you and a book! On the other hand, if the writing style is formal and dry, your 
brain perceives it the same way you experience being lectured to while sitting in a roomful 
of passive attendees. No need to stay awake. 

But pictures and conversational style are just the beginning. . . 
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Here's what WE did: 

We used pictures , because your brain is tuned for visuals, not text. As far as your brain’s 
concerned, a picture really is worth a thousand words. And when text and pictures work 
together, we embedded the text in the pictures because your brain works more effectively 
when the text is within the thing it refers to, as opposed to in a caption or buried in the body 
text somewhere. 

We used redundancy , saying the same thing in different ways and with different media types, 
and multiple senses , to increase the chance that the content gets coded into more than one area 
of your brain. 

We used concepts and pictures in unexpected ways because your brain is tuned for novelty, 
and we used pictures and ideas with at least some emotional content , because your brain 
is tuned to pay attention to the biochemistry of emotions. That which causes you to feel 
something is more likely to be remembered, even if that feeling is nothing more than a little 

humor , surprise , or interest. 

We used a personalized, conversational style , because your brain is tuned to pay more 
attention when it believes you’re in a conversation than if it thinks you’re passively listening 
to a presentation. Your brain does this even when you’re reading. 

We included activities , because your brain is tuned to learn and remember more when 
you do things than when you read about things. And we made the exercises challenging-yet- 
doable, because that’s what most people prefer. 

We used multiple learning styles , because you might prefer step-by-step procedures, while 
someone else wants to understand the big picture first, and someone else just wants to see 
an example. But regardless of your own learning preference, everyone benefits from seeing the 
same content represented in multiple ways. 

We include content for both sides of your brain , because the more of your brain you 
engage, the more likely you are to learn and remember, and the longer you can stay focused. 
Since working one side of the brain often means giving the other side a chance to rest, you 
can be more productive at learning for a longer period of time. 

And we included stories and exercises that present more than one point of view, 
because your brain is tuned to learn more deeply when it’s forced to make evaluations and 
judgments. 

We included challenges , with exercises, and by asking questions that don’t always have 
a straight answer, because your brain is tuned to learn and remember when it has to work at 
something. Think about it — you can’t get your body in shape just by watching people at the 
gym. But we did our best to make sure that when you’re working hard, it’s on the right things. 
That you’re not spending one extra dendrite processing a hard-to-understand example, 
or parsing difficult, jargon-laden, or overly terse text. 

We used people. In stories, examples, pictures, etc., because, well , you’re a person. And your 
brain pays more attention to people than it does to things. 
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Here's what YOU can do to bend 
your brain into submission 

So, we did our part. The rest is up to you. These tips are a 
starting point; listen to your brain and figure out what works 
for you and what doesn’t. Try new things. 

Cut this out dv\d sti£k it 
° h y°u<r refrigerator. 



0 Slow down. The more you understand, the 
less you have to memorize. 

Don’t just read. Stop and think. When the book asks 
you a question, don’t just skip to the answer. Imagine 
that someone really is asking the question. The 
more deeply you force your brain to think, the better 
chance you have of learning and remembering. 

0 Do the exercises. Write your own notes. 

We put them in, but if we did them for you, that 
would be like having someone else do your workouts 
for you. And don’t just look at the exercises. Use a 
pencil. There’s plenty of evidence that physical 
activity while learning can increase the learning. 

0 Read “There Are No Dumb Questions.” 

That means all of them. They’re not optional 
sidebars, they We part of the core content! 

Don’t skip them. 

A Make this the last thing you read before bed. 
Or at least the last challenging thing. 

Part of the learning (especially the transfer to 
long-term memory) happens after you put the book 
down. Your brain needs time on its own, to do more 
processing. If you put in something new during that 
processing time, some of what you just learned will 
be lost. 

O Talk about it. Out loud. 

Speaking activates a different part of the brain. If 
you’re trying to understand something, or increase 
your chance of remembering it later, say it out loud. 
Better still, try to explain it out loud to someone else. 
You’ll learn more quickly, and you might uncover 
ideas you hadn’t known were there when you were 
reading about it. 



0 Drink water. Lots of it. 

Your brain works best in a nice bath of fluid. 
Dehydration (which can happen before you ever 
feel thirsty) decreases cognitive function. 

0 Listen to your brain. 

Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim 
the surface or forget what you just read, it’s time 
for a break. Once you go past a certain point, you 
won’t learn faster by trying to shove more in, and 
you might even hurt the process. 

0 Feel something. 

Your brain needs to know that this matters. Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad joke 
is still better than feeling nothing at all. 

0 Write a lot of code! 

There’s only one way to learn to develop Android 
apps: write a lot of code. And that’s what you’re 
going to do throughout this book. Coding is a skill, 
and the only way to get good at it is to practice. 
We’re going to give you a lot of practice: every 
chapter has exercises that pose a problem for you 
to solve. Don’t just skip over them — a lot of the 
learning happens when you solve the exercises. We 
included a solution to each exercise — don’t be afraid 
to peek at the solution if you get stuck! (It’s easy 
to get snagged on something small.) But try to solve 
the problem before you look at the solution. And 
definitely get it working before you move on to the 
next part of the book. 
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Read me 



This is a learning experience, not a reference book. We deliberately stripped out everything 
that might get in the way of learning whatever it is we’re working on at that point in the 
book. And the first time through, you need to begin at the beginning, because the book 
makes assumptions about what you’ve already seen and learned. 



We assume you’re new to Android, but not to Java. 

We’re going to be building Android apps using a combination of Java and XML. We 
assume that you’re familiar with the Java prorgamming language. If you’ve never done any 
Java programming at all, then you might want to read Head First Java before you start on 
this one. 

We start off by building an app in the very first chapter. 

Believe it or not, even if you’ve never developed for Android before, you can jump right 
in and start building apps. You’ll also learn your way around Android Studio, the official 
IDE for Android development. 

The examples are designed for learning. 

As you work through the book, you’ll build a number of different apps. Some of these are 
very small so you can focus on a specific part of Android. Other apps are larger so you can 
see how different components fit togeher. We won’t complete every part of every app, but 
feel free to experiment finish them off yourself. It’s all part of the learning experience. The 
source code for all the apps here: https://tmyurl.com/HeadFirstAndroid. 

The activities are NOT optional. 

The exercises and activities are not add-ons; they’re part of the core content of the book. 
Some of them are to help with memory, some are for understanding, and some will help 
you apply what you’ve learned. Don’t skip the exercises . 
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The redundancy is intentional and important. 

One distinct difference in a Head First book is that we want you to really get it. And we 
want you to finish the book remembering what you’ve learned. Most reference books 
don’t have retention and recall as a goal, but this book is about learning , so you’ll see some 
of the same concepts come up more than once. 

The Brain Power exercises don’t have answers. 

For some of them, there is no right answer, and for others, part of the learning 
experience of the Brain Power activities is for you to decide if and when your answers 
are right. In some of the Brain Power exercises, you will find hints to point you in the 
right direction. 



you are here ► 



xxxi 



the review team 



the technical review team 




Technical reviewers: 

Edward Yue Shung Wong has been hooked on coding since he wrote 
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^ Diving In + 




Android has taken the world by storm. 

Everybody wants a smartphone or tablet, and Android devices are hugely popular. In this 
book, we’ll teach you how to develop your own apps, and we’ll start by getting you to 
build a basic app and run it on an Android Virtual Device. Along the way, you’ll meet some 
of the basic components of all Android apps, such as activities and layouts. All you 
need is a little Java know-how... 



this is a new chapter 



android overview 



Welcome to Androidville 

Android is the world’s most popular mobile platform. At the 
last count, there were over one billion active Android devices 
worldwide, and that number is growing rapidly. 

Android is a comprehensive open source platform based 
on Linux and championed by Google. It’s a powerful 
development framework that includes everything you need 
to build great apps using a mix of Java and XML. What’s 
more, it enables you to deploy those apps to a wide variety of 
devices — phones, tablets and more. 

So what makes up a typical Android app? 



We’re going to huild our 
Android apps using a mixture 
ol Java and XML. We’ll 
explain things along the way, 
hut you’ll need to have a lair 
understanding ol Java to get 
the most out ol this hook. 



Layouts define what each screen 
looks like 

A typical Android app is comprised of one 
or more screens. You define what each 
screen looks like using a layout to define its 
appearance. Layouts are usually defined using 
XML, and can include GUI components such 
as buttons, text fields, and labels. 

lava code defines what the app 
should do 

Layouts only define the appearance of the app. 
You define what the app does by writing Java 
code. A special Java class called an activity 
decides which layout to use and tells the app 
how to respond to the user. As an example, if 
a layout includes a button, you need to write 
Java code in the activity to define what the 
button should do when you press it. 



Layouts 
tell Android 
what the 
screens in 
your app 
look like. 




Activities de-f'me 
what the app — J 

should do. 



/ \ / \ 
\_/ \_/ 



Sometimes extra resources are needed too 

In addition to Java code and layouts, Android apps often need 
extra resources such as image files and application data. You 
can add any extra files you need to the app. 

Android apps are really just a bunch of files in particular 
directories. When you build your app, all of these files get 
bundled together, giving you an app you can run on your device. 
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The Android platform dissected 

The Android platform is made up of a number of 
different components. It includes core applications such 
as Contacts, a set of APIs to help you control what 
your app looks and how it behaves, and a whole load of 
supporting files and libraries. Here’s a quick look at how 
they all fit together: 



o 
O 

Don’t worry if this seems 
like a lot to take in. 

At this stage, we’re just giving 
you an overview of what’s 
included in the Android platform. We’ll explain 
the different components in more detail as and 
when we need to. 




t "Relax 



Android comes with a set 
of core applications such 
as Contacts, Calendar, 
Maps, and a browser. 

When you build your apps, 
you have access to the 
same APIs used by the 
core applications. You use 
these APIs to control 
what your app looks like 
and how it behaves. 

Underneath the 
application framework 
lies a set of C and C++ 
libraries. These libraries 
get exposed to you 
through the framework 
APIs. 



Underneath everything 
else lies the Linux kernel. 
Android relies on the 
kernel for drivers, and 
also core services such 
as security and memory 
management. 



/ 

i 



Applications 





Home 




Contacts 




Phone 




Browser 















implication Framework 



Activity 


Window 


Content 


View 


Manager 


Manager 


Providers 


System 



Package 


Telephony 


Resource 


Location 


Notification 


Manager 


Manager 


Manager 


Manager 


Manager 



Libraries 



Surface 

Manager 


Media 

Framework 


SQLite 




OpenGL | 
ES 


FreeType 


WebKit 




SGL 


SSL 


libc 



Android Runtime 



Core 

Libraries 



Linux Kernel 



Display 

Driver 




Camera 

Driver 




Flash Memory 
Driver 




Binder (IPC) 
Driver 










Keypad 

Driver 




WiFi 

Driver 




Audiio 

Drivers 




Power 

Management 



The Android 
runtime 
comes with a 
set of core 
libraries that 
implement 
most of 
the Java 
programming 
language. 
Each Android 
app runs 
in its own 
process. 



The great news is that all of the powerful Android 
libraries are exposed through the APIs in the application 
framework, and it’s these APIs that you use to create 
great Android apps. All you need to begin is some Java 
knowledge and a great idea for an app. 
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Here's what we're going to do 



So let’s dive in and create a basic Android app. There are just 
a few things we need to do: 



o 



Set up a development environment. 

We need to install Android Studio, which 
includes all the tools you need to develop your 
Android apps. 




© 

© 

o 



Build a basic app. 

We’ll build a simple app using Android Studio 
that will display some sample text on the 
screen. 



My First App 



Hello world! 



Run the app in the Android emulator. 

We’ll use the built-in emulator to see the app 
up and running. 



Change the app. 

Finally, we’ll make a few tweaks to the app we 
created in step 2, and run it again. 




-there-, Ecce no 

Dumb Questions 




My First App 



Sup doge 



Q? Are all Android apps developed 
in Java? 



You can develop Android apps in 
other languages too, but the truth is most 
developers use Java. 



o? How much Java do I need to know 
for Android app development? 



You really need experience of Java 
SE. If you’re feeling rusty, we suggest 
getting a copy of Head First Java by Kathy 
Sierra and Bert Bates. 



o? Do I need to know about Swing 
and AWT? 



Android doesn’t use Swing or AWT, 
so don’t worry if you don’t have Java 
desktop GUI experience. 
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Your development environment 

Java is the most popular language used to develop Android applications. 
Android devices don’t run .class and .jar files. Instead, to improve speed 
and battery performance, Android devices use their own optimized 
formats for compiled code. That means that you can’t use an ordinary 
Java development environment — you also need special tools to convert 
your compiled code into an Android format, to deploy them to an 
Android device and to let you debug the app once it’s running. 



^ou av-e hev-e* 




All of these come as part of the Android SDK. Let’s take a look at 
what’s included. 
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Set up environment 
Build app 
Run app 
Change app 



The Android SPK 



The Android Software Development Kit contains the libraries and tools 
you need to develop Android apps: 



SDK Platform 

There’s one of these for each 
version of Android. 



SDK Tools 

Tools for debugging and testing, 
plus other useful utilities. It 
also features a set of platform 
dependent tools. 

Sample apps 

If you want practical code 
examples to help you understand 
how to use some of the APIs, the 
sample apps might help you. 




These ave just some 
ot the main joints- 



Documentation 

So you can get to the latest 
API documentation offline. 



Android support 

Extra APIs that aren’t available 
in the standard platform. 



Google Play Billing 

Allows you in integrate billing 
services in your app. 



Android Studio is a special version of IntelliJ IPEA 

IntelliJ IDEA is one of the most popular IDEs for Java development. 
Android Studio is a version of IDEA that includes a version of 
the Android SDK and extra GUI tools to help you with your app 
development. 

In addition to providing you with an editor and access to the tools and 
libraries in the Android SDK, Android Studio gives you templates you 
can use to help you create new apps and classes, and it makes it easy to 
do things such as package your apps and run them. 
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installation 



Install Java 

Android Studio is ajava development environment, so you need to 
make sure the right version of Java is installed on your machine. 

First, check the Android Studio system requirements to see which 
versions of the Java Development Kit JDK) and Java Runtime Edition 
JRE) you need. You can see the system requirements here: 



Set up environment 
Build app 
Run app 
Change app 



Oracle and 6)oo $ le some-tiroes 
change -their URLs. |-f -these 
URLs don't work, do a search. 






http:/. / developer, android, com/sdk/index. html#Requirements 



When you know which versions of the JDK and JRE you need, you 
can get them from here and install them: 



http:/ / www. oracle, com/ technetwork/java/javase/ downloads/index, html 



then install Android Studio it has Ranged, 

search tor /Wroid Studio in 

Once you have Java up and running, you can download Android developer. android-Com. 

Studio from here: ^ 

https:/ / developer, android, com/ sdk/installing/index. html?pkg— studio 

This page also includes installation instructions. Follow the instructions 

to install Android Studio on your computer. Once you’ve installed ^ deluding installation 

Android Studio, open it and follow the instructions to add the latest instructions in this book as they dan jet 

SDK tools and support libraries. ou ^ ° * date pretty ^uiekly. Follow the 

online instructions and you II be tine. 

When you’re done, you should see the Android Studio welcome screen. 

You’re ready to build your first Android app. 



This is the 
Android Studio 
welcome 
screen- It 
includes a set 
ot options tor 
things you Can 
do- 







Android Studio 1.0 Build 135.1629389. Iheck for updates now. 
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O: You say we’re going to use 
Android Studio to build the Android 
apps. Do I have to? 



^Z Strictly speaking, you don’t have to 
use Android Studio to build Android apps. 
All you need is a tool that will let you write 
and compile Java code, plus a few other 
specialist tools to convert the compiled 
code into a form that Android devices can 
run. 




So I can use my own IDE? 



Android Studio is the official Android 
IDE, but Eclipse is also popular. You can 
see further details here: https://developer. 
android.com/tools/sdk/eclipse-adt.html. 



tfieretqre no 

Dumb Questions 



% Can I write Android apps without 
using an IDE? 



It’s possible, but it’s more work. Most 
Android apps are now created using a build 
tool called gradle. Gradle projects can be 
created and built using a text editor and a 
command line. 



Most apps are built using gradle? I 
thought you said a lot of developers use 
Android Studio? 



^Z Android Studio provides a graphical 
interface to gradle, and also to other tools 
for creating layouts, reading logs and 
debugging. 



A build tool? So is gradle like 

ANT? 

^Z Similar, but gradle is much more 
powerful than ANT. Gradle can compile and 
deploy code, just like ANT, but it also uses 
Maven to download any third-party libraries 
your code needs. Gradle also uses Groovy as 
a scripting language, which means you can 
easily create quite complex builds with gradle. 



Build a basic app 



Now that you’ve set up your development environment, you’re 
ready to create your first Android app. Here’s what the app will 
look like: 



This is the name ^ V* 

ot the application. 



My First App 









This is a very simple 
a pp> but that's all you 
. need for your very 
-first Android app. 



There'll be a small pie<* 
of sample text ri^ht 
here that Android 
studio will put in for 



us. 



O 



□ 



you are here ► 




create project 



You VC Completed -this step 
> if of-P 



toOUf . N/^ 



Lets build the basic app 

Whenever you create a new app, you need to create a new 
project for it. Make sure you have Android Studio open, 
and follow along with us. 




Set up environment 
Build app 
Run app 
Change app 



1. Create a new project 

The Android Studio welcome screen gives you a number of 
options for what you want to do. We want to create a new project, 
so click on the option for “Start a new Android Studio project”. 




\ 

Any projects you create 
will appear here. This is our 
-first project, so this area is 
Currently empty. 
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Building a basic app (continued) 

Z. Configure the project 

You now need to configure the app by saying what you want to 
call it, what company domain to use, and where you would like 
to store the files. 

Android Studio uses the company domain and application name 
to form the name of the package that will be used for your app. 
As an example, if you give your app a name of “My First App” 
and use a company domain of “hfad.com”, Android Studio will 
derive a package name of c om . h f a d . my first app . The 
package name is really important in Android, as it’s used by 
Android devices to uniquely identify your app. 

Enter an application name of “My First App”, a company name 
of “hfad.com”, and accept the default project location. Then 
click on the Next button. 




getting started 

Set up environment 
Build app 
Run app 
Change app 



Watch it! 



The package 
name must 
stay the same 
for the lifetime 
of your app. 



It’s a unique identifier for your 
app and used to manage 
multiple versions of the same 
app. 




The wizavd toy-ms 
the package name 
by Combining Ihe 
application name 
and the Company 
domain- 
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api level 



Building a basic app (continued) 

3. Specify the API level 




Set up environment 
Build app 
Run app 
Change app 



You now need to indicate which API level of Android your app will use. 
API levels increase with every new version of Android. Unless you only 
want your app to run on the very newest devices, you probably want to 
specify one of the older APIs. 

Here, we’re choosing API level 15, which means it will be able to run on 
most devices. Also, we’re only going to create a version of our app to run 
on phones and tablets, so we’ll leave the other options unchecked. 



You II see more about the di-M-event 
API levels on the ne%* t pay- 



When you’ve done this, click on the Next button. 



Create New Project 



The minimum required 
is the lowest version your 
app will support- Your app 
will run on devices with 

this level API or higher. It 

won*t run on devices with 
a lower API- 



M New Project 

Android Studio 



Select the form factors your app will run on 

Different platforms require separate SDKs 



0 Phone and Tablet 
l Minimum SDK 



□ TV 

Minimum SDK 

□ Wear 

Minimum SDK 
D Class 

Minimum SDK 



API 15: Android 4.0.3 (IceCreamSandwich) 



3 



Lower API levels target more devices, but have fewer 
features available. By targeting API 15 and later, your app 
will run on approximately 87.9% of the devices that are 
active on the Coogle Play Store. Help me choose. 



API 21: Android 5.0 (Lollipop) 



API 21: Android 5.0 (Lollipop) 



Class Development Kit Preview (Coogle Inc.) (API 19) 



Cancel 



Previous 



Next 



Finish 
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getting started 



Versions Tip C]oSe 



You’ve probably heard a lot of things about Android that sound tasty Things like 
Ice Cream Sandwich, Jelly Bean, KitKat, and Lollipop. So what’s with all the 
confectionary? 

Android versions have a version number and a codename. The version number gives 
the precise version of Android (e.g., 5.0), while the codename is a slightly more generic 
“friendly” name that may cover several versions of Android (e.g., Lollipop). The 
API level refers to the version of the APIs used by applications. As an example, the 



CL 



Version 


Codename 


API level 


1.0 




1 


1.1 




2 


1.5 


Cupcake 


3 


1.6 


Donut 


4 


2.0 


Eclair 


5 


2.01 


Eclair 


6 


2.1 


Eclair 


7 


2.2.x 


Froyo 


8 


2.3-23.2 


Gingerbread 


9 


23.2-2.3.7 


Gingerbread 


10 


3.0 


Honeycomb 


11 


3.1 


Honeycomb 


12 


3.2 


Honeycomb 


13 


4.0 - 4.0.2 


Ice Cream Sandwich 


14 


4.03-4.0.4 


Ice Cream Sandwich 


15 


4.1 


Jelly Bean 


16 


4.2 


Jelly Bean 


17 


4.3 


Jelly Bean 


18 


4.4 


KitKat 


19 


4.4 


KitKat (with wearable extensions) 


20 


5.0 


Lollipop 


21 






/ Hardly 

/ j-i . 



a*yohe uses 
these versions. 



Most devices use 
one of these API S - 



When you develop Android apps, you really need to consider which versions of 
Android you want your app to be compatible with. If you specify that your app is only 
compatible with the very latest version of the SDK, you might find that it can’t be run 
on many devices in the first instance. You can find out the percentage of devices running 
particular versions here : https:/ / developer, android, com/ about/ dashboards /index, html. 
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50,000 feet 



Activities and layouts from 50,000 feet 

The next thing you’ll be prompted to do is add an activity to your project. 
Every Android app is a collection of screens, and each screen is comprised 
of an activity and a layout. 

An activity is a single, defined thing that your user can do. You 

might have an activity to compose an email, take a photo, or find a contact. 
Activities are usually associated with one screen, and they’re written in Java. 

A layout describes the appearance of the screen. Layouts are written 
as XML files and they tell Android how the different screen elements are 
arranged. 

Let’s look in more detail at how activities and layouts work together to 
create a user interface: 




Set up environment 
Build app 
Run app 
Change app 



Layouts define ho 
the user interface 
presented. 



w 

is 



Activities define 
actions. 



o 



The device launches 
your app and creates 
an activity object. 



Q The activity object 
specifies a layout. 



^ The activity tells 

Android to display the 
layout on screen. 




O 



The user interacts 
with the layout that's 
displayed on the device. 



O 



The activity responds 
to these interactions by 
running application code. 



@ The activity updates 
the display... 



Q ...which the user sees 
on the device. 




Now that you know a bit more about what activities and layouts are, 
let’s go through the last couple of steps in the wizard and get it to 
create a basic activity and layout. 
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Building a basic app (continued) 

4. Create an activity 

The next screen gives you a series of templates you can use to 
create an activity and layout. You need to choose one. We’re 
going to create an app with a basic activity and layout, so 
choose the Blank Activity option and click the Next button. 




getting started 

Set up environment 
Build app 
Run app 
Change app 




There are other types ot 
aet iv’rty you tan tboose 
-from, but w^ake sure you 

select tbe Blank Activity 

option- 
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configure activity 



Building a basic app (continued) 

5. Configure the activity 

You will now be asked what you want to call the screen’s activity 
and layout. You will also need to say what the title of the screen will 
be, and specify a menu resource name. Enter an activity name of 
“Main Activity”, and a layout name of “activity_main”. The activity is 
a Java class, and the layout is an XML file, so the names we’ve given 
here will create a Java class file called MainActivity.java and an XML file 
called activity _main. xml. 

When you click on the Linish button, Android Studio will build your 
app. 




Set up environment 
Build app 
Run app 
Change app 




£jive the activity a 
name Jc tt Mai^tvrty w 
and -the layout a name 
of u attwity__main • 
Accept the de-faults 
-for the other options. 



14 



Chapter 1 





You've just created your first Android app 



So what just happened? 

© 



v/ 



getting started 

Set up environment 
Build app 
Run app 
Change app 



The Android Studio wizard created a project for your app, 
configured to your specifications. 

You defined which versions of Android the app should be compatible with, and 
the wizard created all of the files and folders needed for a basic valid app. 

It created a basic activity and layout with template code. 

The template code includes layout XML and activity Java code, with sample 
“Hello world!” text in the layout. You can change this code. 



When you finish creating your project by going through the wizard, 
Android Studio automatically displays the project for you. 

Here’s what our project looks like (don’t worry if it looks 
complicated right now, we’ll break it down over the next few pages): 



This is -the pvojedt m Android Studio. 



000 




activity main. xml - [app] - My First App - 


[-/AndroidStudioProjects/ MyFirstApp] 




0 w 0 1 ♦ 




ItwI ► # n, @! 


| $ is 5 w \ ? | 




C MyFirstApp 


E 1 app E] src El main 


C 5 res Q layout <> activity_main j<ml 







" w 1 Android ▼ © 

O 



■ffi Android 
C -1 app 
► E] manifests 

▼ java 

t EKom.hfad.myfirstapp 
c b MainActivity 

► EKom.hfad.myfirstapp (a 

▼ Cires 

► Eldrawable 
▼ E] layout 

■ activity_main.xml 

► Bmenu 

► E] values 
0 Cradle Scripts 



MainActivity.java ^cj i> activity_main.xml x ^ 

* r a 



0: Messages 



Palette 
n Layouts 
FI FrameLayout 
n LinearLayout (Horizontt 
FI LinearLayout (Vertical) 
BUjTableLayout 
0TableRow 
F3 Grid Layout 
F5 Relative Layout 
El Widgets 
|Ab| Plain TextView 
(Ab| Large Text 
|Ab| Medium Text 
©Small Text 
ot Button 
ok Small Button 
(•-' RadioButton 
0CheckBox 

■ n Switch 
QToggleButton 
3 ImageButton 

ImageView 

■ - ProgressBar (Large) 

■ ■ ProgressBar (Normal) 

■ ■ ProgressBar (Small) 

■ ■ ProgressBar (Horizonta 
■o« SeekBar 

RatingBar 
Spinner 
WebView 
E] Text Fields 
[G Plain Text 
(G Person Name 
(G Password 

Design Text | 

6: Android % TO DO 



I"; Nexus 4-’- 
'#'21- 






- (J)AppTheme MainActivity - 

1^1^ !<n a i 0 at 



Component Tree 
▼ I Device Screen 



: # 



AblTextView - @string/hello_world 




? S T 



layout:height match_parent 
style 

accessibilityLiveRec 

alpha 

background 

backgroundTint 

backgroundTintMoi 

clickable 

contentDescription 

elevation 

focusable 

focusablelnTouchM □ 
gravity [] 

id 



Event Log B Cradle Console 



Memory Monitor 



1 1 Cradle build finished in 24 sec (49 minutes ago) 
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folder structure 



Android Studio creates 
a complete folder structure for you 




Set up environment 
Build app 
Run app 
Change app 



An Android app is really just a bunch of valid files in a particular folder structure, 
and Android Studio sets all of this up for you when you create a new app. The 
easiest way of looking at this folder structure is with the explorer in the leftmost 
column of Android Studio. 



The explorer contains all of the projects that you currently have open. To expand 
or collapse folders, just click on the arrows to the left of the folder icons. 



Choose -the 
pv-ojefct option 
hev-e to see the 
-files and -folders 

that make 

your project- 

This is the 
name o-f the 

project 



Clitk on 
these arrows 
to expand or 
tollapse the 
holders. 

These -files 
and -folders 
are all 
included in 
y our project- 




The folder structure includes different 
types of files 

If you browse through the folder structure, you’ll see 
that the wizard has created various types of files and 
folders for you: 



o 

o 

o 

o 



Java and XML source files 

These are the activity and layout files the 
wizard created for you. 

Android -generated Java files 

There are some extra Java files you don’t 
need to touch which Android Studio 
generates for you automatically. 

Resource files 

These include default image files for 
icons, styles your app might use, and any 
common String values your app might 
want to look up. 

Android libraries 

In the wizard, you specified the minimum 
SDK version you want your app to be 
compatible with. Android Studio makes 
sure it includes the relevant Android 
libraries for this version. 



o 



Configuration files 

The configuration files tell Android what’s 
actually in the app and how it should run. 



Let’s take a closer look at some of the key files and 
folders in Androidville. 
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Useful files in your project 

Android Studio projects use the gradle build system to compile and 
deploy your apps. Gradle projects have a standard layout. Here are 
some of the key files and folders you’ll be working with: 



v/ 



getting started 

Set up environment 
Build app 
Run app 
Change app 



The root folder 
has the same name 
as your project. 



The build/ folder contains files 
that Android Studio creates 
>^^for you. You don't usually edit 
* anything in this folder. 




The src/ folder contains 
source code you write 
and edit. 



The java/ folder contains 
any Java code you write. Any 
activities you create live here. 



You can find system resources 
in the res/ folder. The layout/ 
folder contains layouts, and 
the values/ folder contains 
resource files for values such 
as strings. You can get other 
types of resources too. 



Every Android app must include a 
file called Android Manifest. xml 
at its root. The manifest file 
contains essential information- 
about the app, such as what 
components it contains, required 
libraries, and other declarations. 



Every Android project 
needs a file called 
R.java, which is 
created for you and it 
lives in the generated 
folder. Android uses it 
to help it keep track 
of resources in the 
app. 



com . hfad . myf i rstapp 



j 



R.java 



activity_main.xml 



-□ 



values 




Main Activity, java defines 
an activity. An activity tells 
Android how the app should 
interact with the user. 



activity_main.xml defines a 
1 layout. A layout tells Android 
how your app should look. 



strings.xml contains string id/ 
value pairs. It includes strings 
such as the application name and 
any default text values. Other 
files such as layouts and activities 
can look up text values from here. 



AndroidManifest.xml 
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meet the editors 



Edit code with the Android Studio editors 

You view and edit files using the Android Studio editors. Double- 
click on the file you want to work with, and the file contents will 
appear in the middle of the Android Studio window. 




Set up environment 
Build app 
Run app 
Change app 



The code editor 

Most files get displayed 
in the code editor. The 
code editor is just like a 
text editor, but with extra 
features such as color 
coding and code checking. 



Double— tlitk on -the 

•file in the explorer... 



The design editor 

If you’re editing a 
layout, you have an 
extra option. Rather 
than edit the XML, you 
can use the design 
editor. The design 
editor allows you to 
drag GUI components 
onto your layout, and 
arrange them how you 
want. The code editor 
and design editor give 
different views of the 
same file, so you can 
switch back and forth 
between the two. 
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activity_main.xml - [app] - MyFirstApp - [~/AndroidStudioProjects/MyFirstAppl/ 



X O Sid Aj* j *8 'rapp - ► * & > 3 j $ K. fl 

MyFirstApp C" 1 app Q sre ^ main Cjj res layout <> activity_main.xml 
□ Project ▼ O ^ I 4 " | c Ma'nActivity.java xj m activity_main.xml x I 






W T 



MyFirstApp (-/AndroidStudioProjects/ 

► CD .idea 
▼ Cljjapp 
► CD build 
CD libs 
▼ E]src 

► DandroidTest 
▼ CD main 

▼ CD java 

▼ El com.hfad.myfirstapp 
(£) MairvActivity 

▼ Cires 
CD drawable 
CD layout 

<> activityjriain.xml 

► E]menu 

► E] mipmap-hdpi 

► E] mipmap-mdpi 



f Rela t iveLayou t xmln s : and roid="http : //schemas . and roid . com/apk/ res/ana 
xmlns : tools="http: //schemas . and roid . com/tools" and roid : layout_wig 
and roid : layout_height="match_pa rent" and roid : paddingLef t="@dimenj 
android :paddingRight="@dimen/activity_horizontal_margin" 
android : paddingTop="@dimen/activity_vertical_margin" 
android : paddingBottom= ,, @dimen/activity_vertical_margin" tools : conf 



<TextView and roid : text="@st ring/hello_world" and roid : layout_width^ 
and roid : layout_height="wrap_content" /> 



0</RelativeLayout> 



...and the tile intents 
appear in -tKc editor panel. 



o o 



[j activity_main.xml - [app] - MyFirstApp - [-/AndroidStudioProjects/MyR 



h 0 ; 

MyFirstApp 

|=p Project 



C" 1 app CD sre } £] main Cji res 

o 



L -rapp- ► * 1 
r~l layout <> activity_main.xml 
jOt* I 4- c Main Activity .java x 



MyFirstApp (-/AndroidStudioProjects/ 

► CD. idea 
▼ C; app 

► CD build 
CD libs 
▼ Dsrc 

► DandroidTest 
▼ D main 

▼ E java 

▼ El com.hfad.myfirstapp 

© 'fa MainActivity 

▼ Cares 

El drawable 

▼ El layout 

<> activityjnain.xml 

► El menu 

► El mipmap-hdpi 

► E] mipmap-mdpi 

► El mipmap-xhdpi 

► El mipmap-xxhdpi 

► El values 

► El values-w820dp 
9 AndroidManifest.xml 

B .gitignore 
91 app.iml 
0 build. gradle 
B proguard-rules.pro 

► Dgradle 
B .gitignore 
0 build. gradle 

[4 qradle. properties 



Palette 
P~l Layouts 
[r] FrameLayout 
[FI LinearLayout (Horizonte 
LI LinearLayout (Vertical) 
fjlTableLayout 
f^TableRow 
0 Grid Layout 
F5 Relative Layout 
D Widgets 
|Ab] Plain TextView 
©Large Text 
©Medium Text 
©Small Text 
(ok Button 
|ok Small Button 
(•RadioButton 
(✓ICheckBox 
■ Switch 

ToggleButton 
H ImageButton 
ImageView 

-■ ProgressBar (Large) 

— ProgressBar (Normal) 
— ProgressBar (Small) 

— ProgressBar (Horizonta 
■o* SeekBar 
^ RatingBar 



<> activity_main.xml x 
I" - [1- \%. Nexus 4- 
MainActivity- 







•r 

□ Cradle build finished in 4 sec (12 minutes ago) 



§] Terminal 6: Android 



i 0: Messages 




You dictate 
whieh editor 
youVc using with 
these tabs. 



<1 o □ 



These are 
different 
views ot 
•the same 
-file- The 
-first view 
shows 

-the tode, 
and the 
second 
view shows 
the design. 






getting started 



% Cjfc + 
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Here’s the code from a layout file Android Studio generated for us. 
We know you’ve not seen layout code before, but just see if you can 
match each of the descriptions at the bottom of the page to the 
correct lines of code. We’ve done one to get you started. 



activity_main.xml 

<RelativeLayout xmlns : android="http : / / schemas . android.com/ apk/ res/ android" 

xmlns : tools="http : / / schemas . android . com/ tools " 

android: layout_width="match_parent" 

android: layout_height="match_parent" 

android : paddingLef t=" 1 6dp" 

android : paddingRight=" 1 6dp" 

android : paddingTop=" 1 6dp" 

android : paddingBottom=" 1 6dp" 

tools : context=" .MainActivity"> 



<TextView 

android: text="@string/hello_world" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content 

</RelativeLayout> 



/ 

Display the value of a string 
resource called 
hello world. 



Make the layout the same 
width and height as the 
screen size on the device. 



Add padding to the screen 
margins. 



Include a TextView GUI 
component for displaying 
text. 



Make the text wrap 
horizontally and vertically. 
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solution 















+ < 



Here’s the code from a layout file Android Studio generated for us. We 
know you’ve not seen layout code before, but just see if you can match 
each of the descriptions at the bottom of the page to the correct lines 
of code. We’ve done one to get you started. 



activity_main.xml 

<RelativeLayout xmlns : android= M http : / / schemas . android.com/ apk/ res /android" 
xmlns : tools="http : / / schemas . android . com/ tools" 
android : layout_width="match_parent" 
android: layout_height="match_parent" 
android : paddingLef t=" 1 6dp" 
android : paddingRight=" 1 6dp" 
android : paddingTop=" 1 6dp" 
android : paddingBottom=" 1 6dp " 
tools : context=" .MainActivity"> 

<TextView 

android : text=" @string/hello_world" 

Candroid : layout_width="wrap_content 
^ ? android: layout_height="wrap_content" /> 

</RelativeLayout> 



Add padding to the screen 
margins. 



Include a TextView GUI 
component for displaying 
text. 



* Make the text wrap 
horizontally and vertically. 




Make the layout the same 
width and height as the 
screen size on the device. 



20 Chapter 1 



getting started 
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Now let’s see if you can do the same thing for some activity code. 

This is example code, and not the code that Android Studio 
will have generated for you. Match the descriptions below to the 
correct lines of code. 



MainActivity.java 

package com.hfad.myfirstapp; 

import android . os . Bundle ; 
import android . app . Activity; 

public class MainActivity extends Activity { 

0 Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_main) ; 

} 

} 



This is the package name. 



These are Android classes 
used in MainActivity. 



Implement the onCreate () 
method from the Activity 
class. This method is called 
when the activity is first 
created. 



Specifies which layout to use. 



MainActivity extends the 
Android class 

android . app . Activity. 



you are here ► 
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another solution 















+ < 



Now let’s see if you can do the same thing for some activity code. 

This is example code, and not the code that Android Studio 
will have generated for you. Match the descriptions below to the 
correct lines of code. 



MainActivity.java 
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Run the app in the Android emulator 

So far you’ve seen what your Android app looks like in Android 
Studio and got a feel for how it hangs together. But what you 
really want to do is see it running, right? 

You have a couple of options when it comes to running your 
apps. The first option is to run them on a physical device. But 
what if you don’t have one to hand, or you want to see how it 
looks on a type of device you don’t have? 

An alternative option is to use the Android emulator that’s 
built into the Android SDK. The emulator enables you to set up 
one or more Android virtual devices (AVDs) and then run 
your app in the emulator as though it’s running on a physical device. 



So what does the emulator look like? 

Here’s an AVD running in the Android emulator. It looks just 
like a phone running on your computer. 



v 

v/ 



getting started 

Set up environment 
Build app 
Run app 
Change app 



The Android emulator allows 
you to run your app on an 
Android virtual device (AVD). 
The AVD behaves just like a 
physical Android device. You 
can set up numerous AVDs, 
each emulating a different 
type of device. 



The emulator is an application 
that re-creates the exact hardware 
environment of an Android 
device: from its GPU and memory, 
through to the sound chips and 
the video display. The emulator is 
built on an existing emulator called 
QEMU, which is similar to other 
virtual machine applications you 
may have used, like VirtualBox or 
VMWare. 

The exact appearance and 
behavior of the AVD depends on 
how you’ve set up the AVD in the 
first place. The AVD here is set up 
to mimic a Nexus 4, so it will look 
and behave just like a Nexus 4 on 
your computer. 

Let’s set up an AVD so that you 
can see your app running in the 
emulator. 




OnU you vc set up 
an AVD, you tan see 

your app running on it- 
Android Studio launthes 
the emulator tor you. 



Oust like a physical 
phone, you need to 
unlodk it before 




you start using it 
j— Simply eliek on the 
lodk idon and drag 
it upward. 



you are here ► 



23 



create avd 



Creating an Android Virtual Pevice 

There are a few steps you need to go through in order to set up an 
AVD within Android Studio. We’ll set up a Nexus 4 AVD running API 
level 2 1 so that you can see how your app looks and behaves running 
on this type of device. The steps are pretty much identical no matter 
what type of device you want to set up. 




Set up environment 
Build app 
Run app 
Change app 




Open the Android Virtual Pevice Manager 

The AVD Manager allows you to set up new AVDs, and 
view and edit ones you’ve already created. Open it by 
selecting Android on the Tools menu and choosing AVD 
Manager. 

If you have no AVDs set up already, you’ll be presented 
with a screen prompting you to create one. Click on the 
“Create a virtual device” button. 

Clitk or, ike "Cveaie a virtual-^" 
device” buiior, io tveaie ar, AVD- 



Select the 
hardware 

On the next screen, 
you’ll be prompted 
to choose a device 
definition. This is 
the type of device 
your AVD will 
emulate. You can 
choose a variety of 
phone, tablet, wear, 
or TV devices. 

We’re going to see 
what our app looks 
like running on 
a Nexus 4 phone. 
Choose Phone from 
the Category menu 
and Nexus 4 from 
the list. Then click 
the Next button. 
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Creating an A VP (continued) 



Select a system image 

Next, you need to select a system image. The system image gives you an 
installed version of the Android operating system. You can choose the 
version of Android you want to be on your AVD, and what type of GPU 
(ARM or x86). 

You need to choose a system image for an API level that’s compatible 
with the app you’re building. As an example, if you want your app to 
work on a minimum of API level 15, choose a system image for at least 
API level 15. We’re going to use a system image for API level 21. Choose 
the option for Lollipop 21 armeabi-v7a with a target of Android 5.0.1. 
Then click on the Next button. 




getting started 

Set up environment 
Build app 
Run app 
Change app 



System Image 

Select a system image 



l*f you don't have 
this system image — V 
installed, you'll be 
given the option to 
download it- 



Release Name 


API Level ▼ 


ABI 


Target 


KitKat Wear 


L 


armeabi-v7a 


Android L (Previi 


KitKat Wear 


L 


x86 


Android L (Previi 


Lollipop 


21 


armeabi-v7a 


Android 5.0.1 


Lollipop 


21 


armeabi-v7a 


Google APIs (Co 


Lollipop 


21 


x86 


Google APIs (Co 


Lollipop 


21 


x86_64 


Android SDK Pla 


Lollipop 


21 


x86 


Android SDK Pia 


Lollipop 


21 


x86_64 


System Image x 


KitKat 


19 


armeabi-v7a 


Android 4.4.2 


KitKat 


19 


x86 


Android 4.4.2 


0 Show downloadable system images 


© 



Lollipop 



API Level 

21 

Android 

5.0.1 

Android Open Source 
Project 



System Image 

armeabi-v7a 

- See documentation for Android 5 APIs 



Cancel Previous 



Next 



Finish 



We’ll continue setting up the AVD on the next page. 



you are here ► 
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check configuration 



Set up environment 
Build app 
Run app 
Change app 

Verify the AVP configuration 

On the next screen, you’ll be asked to verify the AVD configuration. This screen 
summarizes the options you chose over the last few screens, and gives you the 
option of changing them. Accept the options, and click on the Finish button. 



Creating an A VP (continued) 




The AVD Manager will create the AVD for you, and when it’s done, display it in 
the AVD Manager list of devices. You may now close the AVD Manager. 



| 0 ^ O 


AVD Manager 


t y Your Virtual Devices 

Android Studio 






26 Chapter 1 





Run the app in the emulator 

Now that you’ve set up your AVD, let’s run the app on it. To do 
this, choose the “Run ‘app’” command from the Run menu. When 
you’re asked to choose a device, make sure the “Launch emulator” 
option is selected, along with the Nexus 4 AVD you just created. 
Then click on the OK button. 

While we wait patiently for the AVD to appear, let’s take a look at 
what happens when you choose Run. 

Compile, package, deploy and run 

Choosing the Run option doesn’t just run your app. It also deals 
with all the preliminary tasks that are needed for the app to run: 




getting started 

Set up environment 
Build app 
Run app 
Change app 





Java file Bytecode AP K file 




Emulator 



the A VD we just Seated- 



An APK lile is an 
Android application 
package. It’s 
basically a JAR 
or ZIP lile lor 
Android applications. 



© 

o 

o 



The Java source files get compiled to 
bytecode. 

An Android application package, or APK 
file, gets created. 

The APK file includes the compiled Java files, 
along with any libraries and resources needed 
by your app. 

Assuming there's not one already 
running, the emulator gets launched 
with the AVD. 



0 



Once the emulator has been launched 
and the AVD is active, the APK file is 
uploaded to the AVD and installed. 



^ The AVD starts the main activity 
associated with the app. 

Your app gets displayed on the AVD screen, 
and it’s all ready for you to test out. 



you are here ► 
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)+- 2: Favorites »» Build Varian 



be patient 



You can watch progress in the console 

It can sometimes take quite a while for the emulator to launch with your 
AVD — often several minutes. The great news is that you can see what’s^— 
happening using the Android Studio console. The console gives you a 
blow-by-blow account of what the gradle build system is doing, and if it 
encounters any errors, you’ll see them highlighted in the text. 

You can find the console at the bottom of the Android Studio screen: 



v/ 



Set up environment 
Build app 
Run app 
Change app 



■ We suggest -finding something else to do 
While waiting -for the emulator to start. 
Like ^uiltmg, or booking a small meal. 




x 



a 



installing com. nTaa.myrirstapp 

DEVICE SHELL COMMAND: pm install -r "/data/local/tmp/com. hfad.myfirstapp" 

pkg: /data/local/tmp/com. hfad.myfirstapp 

Success 

Launching application : com. hf ad . myf irstapp/com. hf ad . myf irstapp . MainActivity . 

DEVICE SHELL COMMAND: am start -n "com. hf ad. myf irstapp/com. hfad.myfirstapp. MainActivity" -a android. intent. action. MAIN -c android. intent. categc 
Starting: Intent { act=android. intent. action. MAIN cat=[android. intent. category. LAUNCHER] cmp=com. hfad.myfirstapp/. MainActivity } 



,> 4: Run ^ TODO 6: Android M Terminal ; 0: Messages 


Event Log [r] Cradle Console fcfl Memory Monitor 


L Cradle build finished in 2 sec (56 minutes ago) 


19:1 n/a n/a | 


Here’s the output from our console window when we ran our app: 


Android Studio launches the emulator with 
AW Nexus^p the AW we just set up. 



Waiting for device. Js- 

/Applications/adt-bundle-mac/sdk/tools/emulator -avd Nexus_4_API_21 -netspeed full -netdelay none 
Device connected: emulator-5554 

Device Nexus_4_API_21 [emulator-5554] is online, waiting for processes to start up. . 

Device is ready: Nexus_4_API_21 [emulator-5554] ^ The AW is up 

Target device: Nexus_4_API_21 [emulator-5554] and running. 

Uploading file 

local path : /Users/dawng/AndroidStudioPro j ects/MyFirstApp/ app/build/ outputs/ apk/ app-debug . apk 
remote path: /data/local/tmp/com. hfad.myfirstapp 
Installing com. hfad.myfirstapp 

DEVICE SHELL COMMAND: pm install -r "/data/local/tmp/com. hfad.myfirstapp" 
pkg: /data/ local/ tmp/ com. hfad.myfirstapp 
Success 

Launching application : com. hfad.myfirstapp/ com. hfad.myfirstapp .MainActivity . 

DEVICE SHELL COMMAND: am start -n "com. hf ad. myf irstapp/com. hfad.myfirstapp .MainActivity" -a 
android. intent .action. MAIN -c android. intent . category . LAUNCHER 

Starting: Intent { act=android. intent . action .MAIN cat= [android. intent . category . LAUNCHER] 
cmp=com. hfad.myfirstapp/ .MainActivity } + 



Upload a»d install the AP^ 
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-Finally, our app is launched by starting the main activity 
tor it- This is the activity the wizard treated -for us. 




Test drive 

So let’s look at what actually happens on screen when you 
run your app. 



\/ 

v 

-►EZ 



getting started 

Set up environment 
Build app 
Run app 
Change app 



First, the emulator fires up in a separate window The 
emulator takes a while to load the AVD, but then after a bit 
you see the locked screen of the AVD. 



The emulator* — ^ 

launches... 






li looks and behaves just like 
a real Nexus f device ■ 



1 



Q 50% 



android 



11:57 




Here s -the 
app runnin 



1 

on -the MV* 

you are here ► 



Android Studio treated the 
sample text w ttello world! -for us 
without us having to tell it- 



When you unlock the AVD screen by 
swiping the padlock icon upward, you see 
the app you just created. The application 
name appears at the top of the screen, and 
the default sample text “Hello world!” is 
displayed in the screen. 



day, December 11 



Charging 

6 



My First App 



Hello world! 



This is the 
title ot the 
application. 



Here s the 
sample text 
the wizard 
Created -for 



Hello world! 
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what happened 



What just happened? 

Let’s break down what happens when you run the app: 



v 

v/ 

-H3 



Set up environment 
Build app 
Run app 
Change app 



O 

© 

© 

© 



Android Studio launches the emulator, 
loads the AVD, and installs the app. 



When the app gets 
launched, an activity 
object is created from 
MainActivity.java. 

The activity specifies 
that it uses the layout 
activity_main . xml . 

The activity tells Android to 
display the layout on the screen. 

The text “Hello world!” gets displayed. 




instate, weVe 
a vivb*al device- 



tlieretqre no 

Dumb Questions 



Q- You mentioned that when you create an APK file, the 
Java source code gets compiled into bytecode and added to 
the APK. Presumably you mean it gets compiled into Java 
bytecode, right? 

It does, but that’s not the end of the story. Things work a little 
differently on Android. 

The big difference with Android is that your code doesn’t actually 
run inside an ordinary Java VM. It runs on the Android runtime 
(ART) instead, and on older devices it runs in a predecessor to 
ART called Dalvik. This means that you write your Java source 
code, compile it into .class files using the Java compiler, and then 
the .class files get stitched into a single file in DEX format, which is 
smaller, more efficient bytecode. ART then runs the DEX code. You 
can see more details about this in Appendix A. 



% That sounds complicated. Why not just use the normal 
Java VM? 



ART can convert the DEX bytecode into native code that can 
run directly on the CPU of the Android device. This makes the app 
run a lot faster, and use a lot less battery power. 




Is a Java virtual machine really that much overhead? 



Yes. Because on Android, each app runs inside its own 
process. If it used ordinary JVMs, it would need a lot more memory. 




Do I need to create a new AVD every time I create a new 



No, once you’ve created the AVD you can use it for any of 
your apps. You may find it useful to create multiple AVDs in order 
to test your apps in different situations. As an example, you might 
want to create a tablet AVD so you can see how your app looks and 
behaves on larger devices. 
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Refining the app 

Over the past few pages, you’ve built a basic Android app and 
seen it running in the emulator. Next, we’re going to refine the 
app you’ve built. 

At the moment, the app displays the sample text “Hello world!’ 
that the wizard put in for us as a placeholder. You’re going to 
change that text to say something else instead. So what do we 
need to change in order to achieve that? To answer that, let’s 
take a step back and look at how the app is currently built. 



The app has one activity and one layout 

When we built the app, we told Android Studio how to 
configure it, and the wizard did the rest. The wizard created a 
basic activity for us, and also a default layout. 



getting started 

Set up environment 
Build app 
Run app 
Change app 



Q 4:42 

My First App : 



Sup doge 

You've -to fcHflny the 
here b> say sowelVmf) 
othev -than "Hello vjovd!"- 





The activity controls what the app does 

Android Studio created an activity for us called 
MainActivity.java. The activity specifies what the app 
does and how it should respond to the user. 



The layout controls the app appearance 

MainActivity.java specifies that it uses the layout Android 
Studio created for us called activity _main. xml. The layout 
specifies what the app looks like. 



We want to change the appearance of the app by changing the 
text that’s displayed. This means that we need to deal with the 
Android component that controls what the app looks like. We 
need to take a closer look at the layout. 




Our activity 
spedi-Cies what the 
app docs and how 
it should interadt 
with the user. 



MainActivity.java 




</Layout 

activity_main.xml 



Our layout spedi-Pies 
what the app looks 



like. 
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the layout 




L^irfcrffLayB^ [Horizonte 
LinearLayout (Vertical) 
j TableLayout 
( TableRow 
/ Grid Layout 
F3 Relative Layout 
^ Wi dgets 
|Ab| Plain TextView 
|Ab| Large Text 
|Ab| Medium Text 
|Ab| Small Text 
gk Button 
ok Small Button 
Radi oButy n 
)*/ CheckBox 
i Switch 
Toggle Button 
J ImageButton 
u ImageView 
*■ Progress Bar (Large) 



Design 



What's in the layout? 



Hello world! 



We need to change the sample “Hello world!” text that 
Android Studio created for us, so let’s start with the layout 
file activity _main.xml. If it isn’t already open in an editor, open 
it now by finding the file in the app/src /main/res /layout folder 
in the explorer and double-clicking on it. 



The design editor 

There are two ways of viewing and editing 
layout files in Android Studio: through the 

design editor and through the code editor. 

When you choose the design option, you can see 
that the sample text “Hello world!” appears in 
the layout as you might expect. But what’s in the 
underlying XML? 

Let’s see by switching to the code editor. 



The design 
editor. 



You £an see the design editor 
by choosing “Design" here- 



\/ 



Run app 
Change app 



The code editor 

When you choose the code editor 
option, the content of 
activity _main.xml is displayed. Let’s take 
a closer look at. 



The fcode 
editor. 







To see the £ode editor, eliek 
on “Text" in the bottom tab 
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activity_wain.xwl has two elements 

Here’s the code from activity _main.xml that Android Studio 
generated for us. 




getting started 

Set up environment 
Build app 
Run app 
Change app 



This is -the 
<Relative 
Layout* 
element- 



<RelativeLayout xmlns : android="http : //schemas . android.com/apk/res/android" 
xmlns : tools="http : / / schemas . android . com/ tools" 
android : layout_width="match_parent" 
android: layout_height="match_parent" 

^ ^ndv-oid Studio $ave us 

move ><ML here, but 
you don t need to think 
about that just yet- 



□ 

MyFirstApp 



This is the -full path 
o( aetivity_main *ml. 



tools : context=" . MainActivity" > 



H* 

app/sre/main 



<TextView 

android : text=" @ string/hello_world" 
android : layout_width="wrap_content" 
android : layout_height="wrap_content 

</RelativeLayout> 




This is the <7extl/iew> 
ele*«e»i nested within the 

<RelativeLayout> element- 



Co 

layout 



activity_main.xml 



The code contains two elements. 

The first element is the <RelativeLayout> 
element. This element tells Android to display items 
on the layout in relative positions. You can use 
<RelativeLayout>, for instance, to center items 
in the middle of the layout, align them to the bottom 
of the screen on your Android device, or position 
them relative to other items. 

The second element is the <TextView> element. 
This element is used to display text to the user. It’s 
nested within the <RelativeLayout>, and in our 
case it’s being used to display the sample text “Hello 
world!”. 

The key part of the code within the <TextView> 
element is the first line. What do you notice? 



Watch it! 



Android Studio sometimes 
displays the values of 
references in place of 
actual code. 



/As an example, it may display 
"Hello world! " instead of the real code 
"@string/hello_world". Any such 
substitutions should be highlighted in the code 
editor, and clicking on them or hovering over 
them with your mouse will reveal the true code. 





l<TextView 

a nd roid : t ext=" Hello wo rid l " 




and roid : text ="@st ring/ hello_wo rid" 




anaroia : iayoui_reigri- wrsp_c on eerie /> 



The Text\Ae>w 

element 
describes the 
text in tbe 



<TextView 

android: text="@string/hello_world" ^ ^ 

android: layout_width="wrap_content" 
android: layout_height="wrap_content" /> 



What do you notice 
about this line? 



layout- 
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strings 



The layout file contains a reference to 
a string, not the string itself 

The key part of the <TextView> element is the first line: 

android : text= M @ s tring/hello_world" /> 

android: text means that this is the text property of the 
<TextView> element, so it specifies which text should be displayed in 
the layout. But why does it say string/hello world" rather than 
“Hello world! 5 ’? What does this actually mean? 

Let’s start with the first part, @ string. This is just a way of telling 
Android to look up a text value from a string resource file. In our case, 
Android Studio created a string resource file for us called strings. xml, 
located in the app/src /main /res /values folder. 

The second part, hello_world, tells Android to look up the value 
of a resource with the name hello_world. So 

@string/hello_world means “look up the string resource with the 
name hello world, and use the associated text value.” 



Display the text.. 



Put string values in 
strings.xml rather than 
hardcoding them, strings. 



xm 



l 



file 






is a resource 
used to hold name/ value 
pairs ol strings. Layouts 
and activities can look up 
string values using their 
name. 

-for string resource hello__v/o\rld- 

<■ 



android: text= TT @string/hello_world n /> 



That seems complicated. 

Why doesn't activity_main.xml 
just include the text? Surely 
that's simpler? 



There’s one key reason: localization 

Say you’ve created an app and it’s a big hit on your local Google 
Play Store. But you don’t want to limit yourself to just one country or 
language — you want to make it available internationally and for different 
languages. 

Separating out text values into strings. xml makes dealing with issues like 
this much easier. Rather than having to change hardcoded text values in a 
whole host of different activity and layout files, you can simply replace the 
strings. xml file with an internationalized version. 

Using strings. xml as a central resource for text values also makes it easier 
to make global changes to text across your whole application. If your 
boss needs you to change the wording in an app because the company’s 
changed its name, only strings. xml needs to be changed. 
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getting started 



Let's look in the strings.xwl file 

Android Studio created a string resource file for us called 
strings. xml, so let’s see if it contains a hello_world resource. Use the 
explorer to find it in the app/src /main /res /values folder, and open it by 
double-clicking on it. 

Here’s what our code in the strings. xml file looks like: 

<?xml version="l . 0" encoding="utf-8"?> 

<resources> 




Set up environment 
Build app 
Run app 
Change app 



□ , 

MyFirstApp 

app/src/main 

^3 



Ti^is is -the -full path 
of str’m$s.%m|. 



<string name="app_name n >My First App</string> 

<string name= M hello_world M >Hello world !</string> 

<string name="action_settings n >Settings</string> ) 

</resources> eludes a sbru* 

with a name of hellojworld^ 

As you can see, there’s a line of code that looks just like what we are a value of w ttello world! • 
looking for. It describes a string resource with a name of hello_ 
world, and a value of “Hello world!”: 



m3 

values 



strings.xml 



<string name="hello_world">Hello world! </string> 



Update strings.xml to change the text 

So let’s change the sample text in the app. If you’ve not already 
done so, find the file strings.xml in the Android Studio explorer, and 
double-click on it to open it. 

Here’s the code from the file. You need to look for the string with 
the name “hello_world”, and change its corresponding text value 
from “Hello world!” to “Sup doge”: 

<?xml version="l . 0" encoding="utf-8"?> 

<resources> 

<string name="app_name">My First App</string> 

<string name= M hello_world">I^^Y0 / AiU2f^ld4- Sup doge</string> 
<string name="action_settings">Settings</ string> 

</ resources> 

Once you’ve updated the file, go to the File menu and choose the 
Save All option to save your change. 



Charge -the value here +rom 
"Hello world!" to "Sup do^e". 
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up close 






String P v eSource files Tip Cl«se 



strings.xml is the default resource file used to hold name/value pairs of 
strings so that they can be referenced throughout your app. It has the 
following format: 



The <resour£es> 
clement 
identifies -the 
^oh-tehis o-P 
"the -Pile as 

resources. 



<?xml version="l . 0" encoding="utf-8"?> 



<resources> 






The <strin<y> element 
identifies the name/ value 
pairs as strings. 



<string name="app_name n >My First App</string> 
<string name="hello_world n >Hello world !</string> 
<string name= n action_settings">Settings</ string> 
</ resources> 



There are two things that allow Android to recognize strings.xml as being a 
string resource file: 

The file is held in the folder app/src/main/res/values. 

XML files held in this folder contain simple values, such as strings and 
colors. 

The file has a < resources > element, which contains one or 
more < string > elements. 

The format of the file itself indicates that it’s a resource file containing 
Strings. The <resources> element tells Android that the file contains 
resources, and the <string> element identifies each String resource. 

This means that you don’t need to call your String resource file 
strings.xml ; if you want, you can call it something else, or split your Strings 
into multiple files. 

Each name/ value pair takes the form 

< s t r i ng name= ” s tr ing_name " >s tr ing_value< / s t r i ng> 



o 

o 



where string_name is the identifier of the string, and string_value 
is the String value itself. 



A layout can retrieve the value of the String using 



" @ s tr ing/ s tr ing_name " 

T 

"string 1 "tells Android "to look for a 
string resource of this na me. 



^ — This is the name of *the 
string whose value we 
want to return. 
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Take the app for a test drive 

Once you’ve edited the file, try running your app in the emulator 
again by choosing the “Run ‘app’” command from the Run 
menu. You should see that your app now says “Sup doge” instead 
of “Hello world!”. 




getting started 

Set up environment 
Build app 
Run app 
Change app 



ttev-e s -the 
updated version 
or our app 
running in the 
emulator. 




tJiereicffe no 

Dumb Questions 



Q? Do I absolutely have to put my text values in a string 
resource file such as strings.xml ? 



It’s not mandatory, but Android gives you warning messages 
if you hardcode text values. It might seem like a lot of effort at first, 
but it makes things like localization much easier. It’s also easier to 
use String resources to start off with, rather than patching them in 
afterward. 



% How does separating out the String values help with 
localization? 



Suppose you want your application to be in English by default, 
but in French if the device language is set to French. Rather than 
hardcode different languages into your app, you can have one 
String resource file for English text, and another resource file for 
French text. 



How does the app know which to use? 

Put your default English strings resource file in the app/src/ 
main/res/values folder as normal, and your French resource file in 
a new folder called app/src/main/res/values-fr. If the device is set 
to French, it will use the strings in the app/src/main/res/values-fr 
folder. If the device is set to any other language, it will use the 
strings in app/src/main/res/values. 



The layout code Android Studio generated for me looks a 
little different than the book’s examples. Should I be concerned? 

Android Studio may give you slightly different XML depending 
on which version you’re using. You don’t need to worry about this, 
because from now on you’ll be learning how to roll your own layout 
code anyway, so you’ll replace a lot of what Android Studio gives you. 



you are here ► 
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CHAPTER 1 



toolbox 




Your Android Toolbox 



You’ve got Chapter 1 under 
your belt and now you’ve 
added Android basic concepts 
to your toolbox. 




BULLET POINTS 



You tan download 
the -full todc -fov- 
the thaftev- fvo**» 
htt^/Ai^Uo*/ 

HeadfirstAndroid- 



Versions of Android have a version 
number, API level, and code name. 

Android Studio is a special version of 
IntelliJ IDEA that interfaces with the 
Android Software Development Kit 
(SDK) and the gradle build system. 



AndroidManifest.xml contains 
information about the app itself. It 
lives in the app/src/main folder. 

An AVD is an Android Virtual Device. 
It runs in the Android emulator and 
mimics a physical Android device. 



Atypical Android app is comprised of 
activities, layouts, and resource files. 

Layouts describe what your app 
looks like. They’re held in the app/ 
src/main/res/layout folder. 

Activities describe what you app 
does, and how it interacts with the 
user. The activities you write are held 
in the app/src/main/java folder. 

strings.xml contains string name/ 
value pairs. It’s used to separate 
out text values from the layouts and 
activities, and supports localization. 



An APK is an Android application 
package. It’s like a JAR file for 
Android apps, and contains your app 
bytecode, libraries, and resources. 
You install an app on a device by 
installing the APK. 

Android apps run in separate 
processes using the Android runtime 
(ART). 

RelativeLayout is used to 
place GUI components in relative 
positions in a layout. 

The Textview element is used for 
displaying text. 
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2 building Interactive apps 

^ Apps That Do Something + 




Most apps need to respond to the user in some way. 

In this chapter, you’ll see how you can make your apps a bit more interactive. You’ll see 
how you can get your app to do something in response to the user, and how to get your 
activity and layout talking to each other like best buddies. Along the way, we’ll take you 
a bit deeper into how Android actually works by introducing you to R, the hidden gem 
that glues everything together. 



this is a new chapter 
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beer adviser 



You're going to build a Peer Adviser 
app 

In the Chapter 1, you saw how to create a basic app using the 
Android Studio New Project wizard, and how to change the 
text displayed in the layout. But when you create an Android 
app, you’re usually going to want the app to do something. 



u 3:35 



Choose your 
beer w 

^Hvi^EER! 



In this chapter, we’re going to show you how to create an app 
that the user can interact with: we’ll be creating a Beer Adviser 
app. In the app, users can select the types of beer they enjoy, 
click a button, and get back a list of tasty beers to try out. 

Here’s how the app will be structured: 



, Jail PalaAle 

- ahd MGtSlAt 

app domes 

up with a 
lis-t <4* bee\r 

suggestions. 



o 



The layout specifies what the app will 
look like. 

It includes three GUI components: 

• A drop-down list of values called a spinner, 
which allows the user to choose which type of 
beer they want. 

• A button that when pressed will return a 
selection of beer types. 

• A text field that displays the types of beer. 



Q The file strings. xml includes any string 
resources needed by the layout— for 
example, the label of the button 
specified in the layout. 



Q 



The activity specifies how the app 
should interact with the user. 

It takes the type of beer the user chooses, and 
uses this to display a list of beers the user might 
be interested in. It achieves this with the help of a 
custom Java class. 



o 



The custom Java class contains the 
application logic for the app. 

It includes a method that takes a type of beer as a 
parameter, and returns a list of beers of this type. 
The activity calls the method, passes it the type of 
beer, and uses the response. 



This is v/hat *tbc 
. layout looks like. 




strings.xml 



Activity 




Custom Java 
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building interactive apps 



Here's what you need to do 

So let’s get to work and build the Beer Adviser app. There 
are a few steps you need to go through (we’ll tackle these 
throughout the rest of the chapter): 



o 



Create a project. 

You’re creating a brand-new app, so you’ll need to create a new 
project. Just like before, you’ll need to create a basic layout and 
activity 



© 



Update the layout. 

Once you have a basic app set up, you need to amend the layout 
so that it includes all the GUI components your app needs. 




light w 

FIND BEER! 

Jail Pale Ale 
Gout Stout 




o 

© 



Wire the layout to the activity. 

The layout only creates the visuals. To add smarts to your app, 
you need to wire the layout to the Java code in your activity. 




Write the application logic. 

You’ll add a Java custom class to the app, and use it to make 
sure users get the right beer based on their selection. 




you are here ► 
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create project 



Create the project 

Let’s begin by creating the new app (the steps are similar to 
those we used in the previous chapter): 



Create project 
Update layout 
Connect activity 
Write logic 



O 

O 

o 



Open Android Studio and choose “Start a new Android Studio project” from the 
welcome screen. This starts the wizard you saw in Chapter 1 . 

When prompted, enter an application name of “Beer Adviser”, making your 
package name com . hf ad . beeradviser. 

We want the app to work on most phones and tablets, so choose a minimum SDK 
of API 15, and make sure the option for “Phone and Tablet” is ticked. This means 
that any phone or tablet that runs the app must have API 1 5 installed on it as a 
minimum. Most Android devices meet this criteria. 



o 



Choose a blank activity for your default activity. Call the activity “FindBeerActivity” 
and the accompanying layout “activity_fmd_beer”. Accept the default values for 
Title and Menu Resource Name, as we won’t be using these. 



Applicati on name: Beer Advi ser 
Company Domain: 

Package name: com. hf ad. beeradviser 

Project location: 



The vji^av-d will -take you -through these steps, 
just like be-Core Call yo*r agitation “Beer 
• ^ Adviser," make sure it uses a minimum SP< o+ 
API 15, then tell it to dreate a blank adtivity 
dalled "Pindbeer Adtivity" and a layout dalled 

"adtivity__t m O ee ' r - 



Phone and Tablet 



Minimum SDK API 15: Android 4.0.3 (IceCreamSandwich) 



Lower API levels target more devices, but have fewer 
features available. By targeting API 15 and later, your app 
i will run on approximately 87.9% of the devices that are 
active on the Google Play Store. Help me choose. 



Activity Name: 
Layout Name: 
Title: 



FindBeerActivity 



Blank Activity 



Menu Resource Name: 
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building interactive apps 



We've created a default activity and layout 

When you click on the Finish button, Android Studio creates a new 
project containing an activity called FindBeer Activity. java and a layout called 
activity _find_beerxml. Let’s start by changing the layout file. To do this, go to 
the app/src /main/res /layout folder, and open the file activity _Jind_beer.xml. 

Just like before, the wizard has created a default layout for us with a “Hello 
world!” <TextView> element on the page like this: 



BeerAdviser 



□ 

Wise 

413 

app/sre/main 

mb 



CO 

413 

layout 



The layout XML 

<RelativeLayout xmlns : android= M http : / / schemas . android . com/ apk/ res/android 
xmlns : too ls=" http : / / schemas . android . com/ tools" 



activity_find_beer.xml 



android : layout_width="match_parent" 
android: layout_height="match_parent" 
android : paddingLef t=" 1 6dp M 
android : paddingRight=" 1 6dp" 
android : paddingTop=" 1 6dp" 
android : paddingBottom=" 1 6dp" 
tools : context=" . FindBeerActivity"> 





These elements relate 
to the layout as a whole- 
They determine the 
layout width and height, 
along with any padding 
in the layout margins. 



</RelativeLayout> 

The design editor 



The <Te*t\/iew> in the )<ML is 
re-fledted in the design editor- 







1 activity find beer.xml - [m 


ap] - Beer Adviser - [-/AndroidStudioProjects/BeerAdviser] J 


j -rapp ► ft P* ^ ifTs l k 


i “ % 




/ c rindBeerActivity.java x | Si activity_find_ 


peer. xml x 


) Palette I* - 

[ C3 Layouts 
) FrameLayout 


[X- id] Next 


j\4- - (jjAppTheme FindBeer- - 21- 

\ [sf ® ® ® □ C5 <1 



IT1 LinearLayout (Horizons 
EH LinearLayout (Vertical) 
jjjTableLavout 
^TableRow 
EdCridLayout 
m Relative Layout 
E] Widgets 
(Ab) Plain TextView 
(Abl Large Text 
(Ab| Medium Text 
(Ab) Small Text 
OK Bul 

1 



I^H ello^vori d^^ 



you are here ► 



43 



design editor 



Adding components with the design editor 

There are two ways of adding GUI components to the layout: via XML or 
using the design editor. Let’s start by adding a button via the design editor. 

To the left of the design editor, there’s a palette that contains GUI components 
you can drag to your layout. If you look in the Widgets area, you’ll see that 
there’s a Button component. Click on it, and drag it into the design editor. 




Create project 
Update layout 
Connect activity 
Write logic 







fWs the palette. 



Here’s the Button- Pva 3 it 
over to the layout- 



| 



Or \m Nexus 4^ 

0 m mi- 



(j} AppTheme 



- 



pLilcttc 



FmdBeer^ 



2 L^ 






n Widgets 
|Ab) Plain TextView 
lAb) Large Text 
|Ab) Medium Text 
AbUisail Text 



®. a 



(• RadioButton 
/ CheckBox 
mi Switch 

Toggle Button 
U ImageButton 
a ImageView 
-■ Prog res sBar (Large) 

■ Progress Bar (Normal) 
™ ProgressBar (Small) 



i We placed ours under 

| the u ttello world/" 

text- 



Changes in the design editor are reflected in the XML 



Dragging GUI components to the layout like this is a convenient way of 
updating it. If you switch to the code editor, you’ll see that adding the 
button via the design editor has added some lines of code to the file: 



There* s a new Button 
element that describes 
the new button you ve 
draped to the layout- 
We II look at this in 
more detail over the 
next £ew pays. 



The dode the design editor adds 
depends on where you plade the 
button. It's likely that your layout 
will look different to ours, but 
don*t worry, weVe dhanging it soon. 



<TextView 

android : text="@string/hello_world" 
android : layout_width="wrap_content" 
android : layout_height="wrap_content " 

android: id= M @+id/textView M /> _ 

I he Textl/iew element we had 

<Button ^-Pore has been given an ID- 

android : lay out_width= M wrap_con tent" 
android : layout_height="wrap_content " 
android: text=" New Button" 
android: id="@+id/button" 
android : layout_below=" @+id/ textView" 
android: lay out_alignLeft="@+id/ textView" /> 
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building interactive apps 



activitY_fi«d_beer.xml has a new button 

The editor added a new <Button> element to activity _Jind_beerxml\ 
<Button 

android: layout_width="wrap_content " 

android: layout_height="wrap_content" 

android : text="New Button" 

android: id=" 0+id/button" 

android : layout_below=" 0+id/ textView" 

android : layout_alignLef t=" @+id/ textView" / > 

A button in Androidville is a push-button that the user can press to trigger 
an action. It includes properties controlling its position, size, appearance, 
%and what methods it should call in the activity. These properties aren’t 
unique to buttons — other GUI components including text views have them 
too. 



buttons and text views are subclasses of the same Android View class 



There’s a very good reason why buttons and text views have 
properties in common — they both inherit from the same Android 
View class. You’ll find out more about this later in the book, but for 
now, here are some of the more common properties. 

android.id 

This gives the component an identifying name. The I D property 
enables you to control what components do via activity code, and also 
allows you to control where components are placed in the layout: 

android: id=" 0+id/button" 



androidrtext 

This tells Android what text the component should display. In the 
case of <Button>, it’s the text that appears on the button: 

android : text="New Button" 

android:layout_width, android:layout_height 

These properties specify the basic width and height of the 
component. "wrap_content ” means it should be just big enough 
for the content: 

android : layout_width="wrap_content" 
android : layout_height="wrap_content" 



The \/iew dass includes lots o-f 
di*f*f event methods. We II look 
at this later m the book. 



V 




you are here ► 
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layout code 



A closer look at the layout code 

Let’s take a closer look at the layout code, and break it down so that 
you can see what it’s actually doing (don’t worry if your code looks a 
little different, just follow along with us): 




Create project 
Update layout 
Connect activity 
Write logic 



The Relative 

Layout 

element- 



^ <RelativeLayout xmlns : android= M http : //schemas . android . com/ apk/res /android" 
xmlns : tool s=" http: //schemas . android.com/tools" 
android : layout_width="match_parent" 
android : layout_height="match_j?arent " 
android : paddingLef t=" 16dp" 
android : paddingRight=" 1 6dp" 
android : paddingTop= " 1 6dp " 
android : paddingBottom=" 16dp" 
tools : context=" . FindBeerActivity"> 



This is the 
te%t view 



CTextView 

android : text=" @ s tring/hello_world" 
android : lay out_width="wrap_con tent" 
android : layout_height="wrap_content " 
android : id=" @+id/textView" /> 



□ 

BeerAdviser 

43 

app/sre/main 

H3 



This is -the <Button 

button. android: layout_width="wrap_content" 

android : layout_height="wrap_content " 
android: text= "New Button" 
android : id=" @+id/button" 
android : layout_below=" @+id/ textView" 
android: layout_alignLeft="@+id/ textView" /> 



m3 



layout 




activity_find_beer.xml 



</Relativ e Layout> <-~This closes the Relative Layout element 



The Kelativelayout element 



The first element in the layout code is <RelativeLayout>. The 
<RelativeLayout> element tells Android that the different GUI -4 
components in the layout should be displayed relative to each other. As 
an example, you can use it to say that you want one component to 
appear to the left of another one, or that you want them to be aligned 
or lined up in some way 



There are other ways ot laying 
out your £jUI Components too- 
You'll -find out more about 
these later on- 



In this example, the button appears directly underneath the text view, 
so the button is displayed relative to the text view 
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building interactive apps 



The TextView element 

The first element inside the <RelativeLayout> is the <TextView>: 



CTextView 

android : text="@string/hello_world" 
android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android : id=" 0+id/textView" /> 



No properties have been set to specify where the text view should appear 
in the layout, so by default Android displays it in the upper-left corner of 
the screen. Notice that the text view has been given an ID of textView. 
You’ll see why this is needed when we look at the next element. 

The Button element 

The final element inside the <RelativeLayout> is the <Button>: 



<Button 

android : layout_width="wrap_content" 

android : layout_height="wrap_content " 

android : text="New Button" 

android: id=" @+id/button M 

android : layout_below=" @+id/ textView" 

android: layout_alignLef t=" @+id/ textView" /> 



When we added our button to the layout, we positioned the button so that 
it was underneath the text view, and so that the left edge of the button 
lined up with the left edge of the text view. We positioned the button 
relative to the text view, and this is reflected in the XML: 

android : layout_below=" @+id/ textView" 
android: layout_alignLef t=" @+id/ textView" 



Using a relative 
layout means that 
GUI components 
will he positioned 
relative to each 
other. 



The text view is displayed 
in -the uppey-le-ft doyney by 
de-fault 




The button is set to appeay below 
the text view, and with its le-ft 
edge veytidally aligned to the le-ft 
edge o-f the text view. 



There are different ways of writing the layout XML in order to produce 
the same visual effect. As an example, the XML above specifies that the 
button is positioned below the text view. An equivalent statement would be to 
say that the text view is positioned above the button. 



you are here ► 
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update layout 



Changes to the XML... 

You’ve seen how changes you make in the design editor are 
reflected in the layout XML. The opposite applies too — any 
changes you make to the layout XML are applied to the 
design. 

Try this now. Replace your activity _find_beer. xml code with the 
following: 



□ 

BeerAdviser 

Hn 

app/src/main 

ma 




activity_find_beer.xml 



<RelativeLayout xmlns : android="http : / / schemas . android . com/ apk/ res/ android" 
xmlns : tools="http : / / schemas . android . com/ tools" 
android : layout_width="match_parent" 
android : layout_height="match_parent " 
android : paddingBottom=" 1 6dp" 
android : paddingLef t=" 1 6dp" 
android : paddingRight=" 1 6dp" 
android : paddingTop=" 1 6dp" 
tools : context=" . FindBeerActivity" > 



A spinnev is the 
Android name -fov* 
a drop-down list 
o( values. It allows 
you to dhoose a 
single value -from a 
selection. 




This element displays a 
spinner in the layout- A 
spinner is a drop— down 
list o-C values. 



Plade a button 
below the spinner 
and le-Pt— align it to 
the spinner. 



Plade a te*t view 
below the button 
and le-Ct-align it 
to the button. 





android : id=" @+id/brands " 
android : lay out_width="wrap_con tent" 
android : layout_height="wrap_content " 
android: layout_alignLeft="@+id/find_beer" 
android : layout_below=" @+id/f ind_beer " 
android : layout_marginTop=" 18dp" 
android: text="TextView" /> 



</RelativeLayout> 




Replace the contents of 
activity _find_beer.xml 
with the XML shown here. 
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...are reflected in the design editor 

Once you’ve changed the layout XML, switch to the design 
editor. Instead of a layout containing a text view with a button 
underneath it, you should now see a text view displayed below a 
button. 

Above the button we have a spinner. A spinner is the Android 
term for a drop-down list of values. When you touch it, it 
expands to show you the list so that you can pick a single value. 




building interactive apps 

Create project 
Update layout 
Connect activity 
Write logic 



A spinner provides 
a drop-down list ol 
values. It allows you to 
choose a single value 
from a set ol values. 

GUI components such 
as buttons, spinners, 
and text views have 
very similar attributes, 
as they are all types 
ol View. Behind the 
scenes, they all inherit 
Irom the same Android 
View class. 




We’ve shown you how to add GUI components to the layout with the 
aid of the design editor, and also by adding them through XML. In 
general, you’re more likely to hack the XML to get the results you 
want without using the design editor. This is because editing the XML 
directly gives you more direct control over the layout, and means that 
you’re not dependent on the IDE. 



you are here ► 
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add strings 



Use string resources rather 
than hardcoding the text 

There’s one more thing we need to change before we try 
running the app. At the moment, the button and text view 
both use hardcoded string values for their text properties. As 
we mentioned in Chapter 1, it’s a good idea to change these 
to use the strings resource file strings. xml instead. While this 
isn’t strictly necessary, it’s a good habit to get into. Using the 
strings resource file for static text makes it easier to create 
international versions of your app, and if you need to tweak 
the wording in your app, you’ll be able to do it one central 
place. 

Open up the app /src /main/res /values /strings, xml file. When you 
switch to the XML view, it should look something like this: 




Create project 
Update layout 
Connect activity 
Write logic 



<?xml version="1.0" encoding="utf-8 " ?> 
<resources> 






These are strings that Android 
Studio Created -for us. 



<string 

<string 

<string 



name= " app_name " >Beer Adviser</ string> 
name="hello_world">Hello world ! </ string> 
name="action_settings">Settings</ string> 



</ resources> 



First, delete the “hello_world” resource, as we’re no longer 
using it. Then, add a new resource called “find_beer” with 
a value of “Find Beer!”. After you’ve done that, add a new 
resource named “brands” but don’t enter anything for the 
value. 

Your new code should look like this: 

<string name="app_name">Beer Adviser</string> 



□ 

BeerAdviser 

app/src/main 

ma 




values 




strings.xml 






<string name= n action_settings">Settings</ string> 

<string name= M find_beer M >Find Beer !</string> 
<string name="brands"X/string> ^ . 



You need to remove the 
hello_world string resource, 
and add in -two new ones 
called -f indjbeer and brands. 



50 Chapter 2 



building interactive apps 



Change the layout to use the string resources 

Next, let’s change the button and text view elements in the 
layout XML to use the two string resources we’ve just added. 

Open up the activity _Jind_ beer xml file, and make the following 
changes: 



o 

o 



Change the line android : text="Button" to android : text=" @string/f ind_beer 
Change the line android: text="TextView" to android: text="@string/brands". 



<Spinner 

android : 
android: 
android : 
android : 
android: 
android : 

<Button 

android : 
android: 
android: 
android : 
android: 
android: 

CTextView 

android: 
android : 
android: 
android : 
android : 
android: 
android : 



id=" @+id/ color" 
layout_width="wrap_content" 
layout_height="wrap_content " 
layout_alignParentTop="true" 
layout_centerHorizontal="true" 
layout_marginTop=" 37dp" /> 



BeerAdviser 



□ 

Ivisc 

app/src/main 

K3 



MTJ 

layout 



activity_find_beer.xml 

id="@+id/ find_beer" 
layout_width="wrap_content" 
layout_height="wrap_content" 
layout_alignLeft=" @+id/ color" 

layout below=" @+id/color" . , 

— - This will display *the value 
text="0string/find_beer" />*T j ^ ^ing 

vesouv£e on "the button- 

id="@+id/brands" 
layout_width="wrap_content " 
layout_height="wrap_content" 
layout_alignLef t=" @+id/ f ind_beer " 
layout_below=" @+id/ f ind_beer " 

n ” ■ „ If1Q , ,r This Will display the value of the brands 

st ' rm 9 'resource m the TextVW While this 
text="0string /brands" /> *= is Currently blank, this ensures any -future 

Changes to the string value will get picked up. 
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test drive 




Let's take the app for a test drive 



We still have more work to do on the app, but let’s see how it’s 
looking so far. Save the changes you’ve made, then choose the 
“Run ‘app’” command from the Run menu. When prompted, 
select the option to launch the emulator. 



Wait patiently for the app to load, and eventually it should 
appear. 




Try touching the spinner. It’s not immediately obvious, but 
when you touch the spinner, it presents you with a drop-down 
list of values — it’s just at this point we haven’t added any 
values to it. 



Here's what we've done so far 



Here’s a quick recap of what we’ve done so far: 



o 

© 

© 



We've created a layout that specifies 
what the app will look like. 

It includes a spinner, a button, and a text view. 

The file strings. xml includes the string 
resources we need. 

We’ve added a label for the button, and an empty 
string for the brands. 

The activity specifies how the app 
should interact with the user. 

Android Studio has created a basic activity for us, 
but we haven’t done anything with it yet. 




strings.xml 



Activity 



V 



Create project 
Update layout 
Connect activity 
Write logic 




This is -the sp'm«ev, 

bwt it has no ^ 

valves in it 



FIND BEER! 



'Y 

The bu-bfcon is under^ea-th 
-the spinner, and also le-Pi- 
alijned -fco i-t- 



the reidre no 

i— Dumb Questions - 

% The layout looks slightly different 
when you run it compared with how it 
looks in the design editor. Why’s that? 

The design editor does its best to show 
you how the layout will look, but it has a few 
limitations. Our layout XML speefies that the 
spinner should be centered horizontally, for 
instance, but this may not be obvious from 
the design editor. 

In practice, you’re always best off working 
directly with the XML. This gives you a more 
accurate picture of what’s going on, and 
gives you a finer degree of control too. 






I thought there was a text view too? 

There is, it’s just that at the moment it 
doesn’t contain any text so you can’t see it. 
You’ll see it later on in the chapter when we 
get the text view to display some text. 
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Add values to the spinner 

At the moment, the layout includes a spinner, but it doesn’t have anything in it. 
Whenever you use a spinner, you need to get it to display a list of values so that 
the user can choose the value they want. 

We can give the spinner a list of values in pretty much the same way that we set 
the text on the button and the text view: by using a resource. So far, we’ve used 
strings. xml to specify single String values. All we need to do is specify an array of 
String values, and get the spinner to reference it. 

Adding an array resource is similar to adding a string 

As you already know, you can add a string resource to strings, xml using 

<string name="string_name">string_value</ string> 




building interactive apps 

Create project 
Update layout 
Connect activity 
Write logic 



Resources are 
noncode assets, 
suck as images 
or strings, used 
hy your app. 



where string_name is the identifier of the String, and string_value is the 
String value itself. 

To add an array of Strings, you use the following syntax: 



< s tr ing - array name= " s tr ing_ar r ay_name " > 
<i tem>s tr ing_value 1< / i tem> 



-This is -the name o*f *the array- 



<item>string_value2</item> > These are -the values in the array, /ou 
<item>string_value3</item> j £dn add as many as you need. 



</string-array> 



where string_array_name is the name of the array, and 
string_valuel, string_value2, string_value3 are the 
individual String values that make up the array. 



Let’s add a string-array resource to our app. Open up 
strings. xml, and add the array like this: 



<string name="brands"></ string> 

<string-array name= "beer_color s " > 
< i tem>l i gh t< / i tem> 

< i t em>ambe r< / i t em> 

<i tem>brown</ i tem> 




□ 

BeerAdviser 

4a 

app/src/main 

HB 



< i tem>dar k< / i t em> 
</string-array> 



</ resources> 



Add this string-array to tile strings.xml. 
It de-fines an array of strings tailed 
beer_dolors with array items of light, 
dmbev, brown, and dark. 



43 

values 



strings.xml 



you are here ► 
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test drive 



fret the spinner to reference a string-array 

A layout can reference a string- array using similar syntax to how it would retrieve 
the value of a string. Rather than use 



"@string/ string_name" 






you use the syntax 

" @ array/ ar ray_name " 

where array_name is the name of the array 




Use ®stv'm3 *to ve-fevende d sfer'mg, and 
0av-vay *to ve*f evende an avvay. 



Let’s use this in the layout. Go to the layout file activity _find_beerxml and add an 
entries attribute to the spinner like this: 

<Spinner 



android : layout_marginTop=" 37dp" 

android: entries="@array/beer_colors" /> 

This means "the entries -f or the 
syinnev- dome trom array beer_dolors 



BeerAdviser 



□ 

ivis( 

43 

app/sre/main 

na 



CO 

M3 

layout 



activity_find_beer.xml 



Test drive the spinner 



So let’s see what impact these changes have had on our app. Save your 
changes, then run the app. You should get something like this: 





u 11:51 1 


Beer Adviser 


: 



Create project 
Update layout 
Connect activity 
Write logic 



By de-fault -o 
tte top item li9ht ’ 

ih “the spihhCV FIND BEER! 

is seled-ted. 




r> 


light 


Ckk oy\ the 




spi mer to see 


amber 


its envies. 


brown 




dark 



ER! 
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When you di£k oy\ a value, i-t gets selected, 
amber ▼ 



FIND BEER! 







building interactive apps 



We need to make the button do something 

So far, we’ve added new GUI components to the layout, and 
populated a spinner with an array of values. What we need to do 
next is make the app react to the value we select in the spinner when 
the button is clicked. We want our app to behave something like this: 



y* Create project 

~ Update layout 

Connect activity 
Write logic 



© 



The user chooses a type of beer 
from the spinner. 

The user clicks on the button to find 
matching beers. 



Q BeerExpert's getBrands() method 
finds matching brands for the type 
of beer and returns them to the 
activity as an ArrayList of Strings. 



© 



The layout specifies which method 
to call in the activity when the 
button is clicked. 



^ The method in the activity 

retrieves the value of the selected 
beer in the spinner and passes 
it to the getBrands() method 
in a Java custom class called 
BeerExpert. 



O 



The activity gets a reference to 
the layout text view and sets its 
text value to the list of matching 
beers. 

This is displayed on the device. 




Let’s start by getting the button to call a method. 



you are here ► 
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onClick attribute 



Make the button call a method 

Whenever you add a button to a layout, it’s likely you’ll want it to do 
something when the user clicks on it. To do this, you need to get the 
button to call a method in your activity 

To get a button to call a method in the activity when it’s clicked, we 
need to make changes to two files: 




o 

o 



We need to change the layout file activity_find_beer.xml. 

We’ll specify which method in the activity will get called when the button is 
clicked. 

We need to change the activity file FindBeerActivity.java. 

We need to write the method that gets called. 



Create project 
Update layout 
Connect activity 
Write logic 



Let’s start with the layout. 



Use onClick to say which method the button calls 



It only takes one line of XML to tell Android which method a 
button should call when it’s clicked. All you need to do is add an 
android: onClick attribute to the <button> element, and give 
it the name of the method you want to call: 

This means W when “the dompenenb is didked; dal I ^ 

ike we-thod m ike activity called method_nar»e" 



android: onClick= "method name” 



Let’s try this now. Go to the layout file activity _find_ beer xml^ and add 
a new line of XML to the <button> element to say that method 
onClickFindBeer () should be called when the button is clicked: 



<Button 

android: id="@+id/ find_beer" 
android : layout_width="wrap_content" 
android : layout_height="wrap_content" 
android: layout_alignLef t=" @+id/ color" 
android: layout_below=" @+id/ color" 
android : text=" @ string/ f ind_beer " 
android: onClick=" onClickFindBeer" /> 



□ 

BeerAdviser 

4T3 

app/src/main 



m3 



layout 




Once you’ve made these changes, save the file. 

Now that the layout knows which method to call in the activity, 
we need to go and write the method. Let’s take a look at the 
activity. 



When ihe bu-bton is didked, 
£all mebhod onClidkFindBeev-0 
in -the activity. Well dreabe 
bhe mebhod in bhe adbiviby 
over bhe ne*b -Pew pages. 



activity_find_beer.xml 
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What activity code looks like 



When we first created a project for our app, we asked the wizard to create a 
basic activity for us called FindBeer Activity. The code for this activity is 
held in a file called FindBeerActivity.java. Open this file by going to the app/src/ 
main/java folder and double-clicking on it. 

When you open the file, you’ll see that Android Studio has generated a lot of 
Java code for you. Rather than taking you through all the code that Android 
Studio has created for you, we want you to replace it with the code below. 

This is because a lot of the activity code that Android Studio has generated is 
unnecessary, and we want you to focus on the fundamentals of Android itself 
rather than the quirks of a single IDE. So delete the code that’s currently in 
FindBeerActivity.java , and replace it with the code shown here: 



□ 

BeerAdviser 

HB 

app/src/main 

Hd 

java_ 

com.hfad.beeradviser 

LQ 



FindBeerActivity.java 



package com.hfad.beeradviser; 



import android . os . Bundle ; 
import android . app . Activity ; 






The dlass expends 
Activity dlass. 



•the A^dvo'id 



public class FindBeer Activity extends Activity { 

-This is -the onCveateO method. It's tailed 

0 Override "he* the activity * 6wt treated- 

protected void onCreate (Bundle savedlnstance State) { 



super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_f ind_beer ) 



^ — seiConienil/iew -tells Android 
' whidh layout the adtivity uses. f» 
this ease, it's activity_+ m d_beev-. 



The above code is all you need to create a basic activity. As you can see, it’s a 
class that extends the android . app . Activity class, and implements an 
onCreate ( ) method. 

All activities have to extend the Activity class. The Activity class contains 
a bunch of methods that turn your Java class from a plain old Java class into a 
full-fledged, card-carrying Android activity. 

All activities also need to implement the onCreate () method. The 
onCreate () method gets called when the activity object gets created, and it’s 
used to perform basic setup such as what layout the activity is associated with. 
This is done using the setContentView () method. In the example above, 
setContentView (R . layout . activity_f ind_beer ) tells Android 
that this activity uses activity_f ind_beer as its layout. 

On the previous page, we added an onClick attribute to the button in our 
layout and gave it a value of onClickFindBeer. We need to add this method 
to our activity so it will be called when the button gets clicked. This will enable 
the activity to respond when the user touches a button in the user interface. 




Replace the code 
in your version of 
FindBeerActivity.java 
with the code shown 
on this page. 



you are here ► 



57 



on ClickFindBeerQ 



Add an onClickFindPeerO method 
to the activity 

The onClickFindBeer () method needs to have a particular 
signature, otherwise it won’t get called when the button specified in the 
layout gets clicked. The method needs to take the following form: 

public void onClickFindBeer (View view) { 

C' \ \ 

The method must be The method must have a The method must have a single 

public. void return value- parameter ot type \/iew. 



vy Create project 

~ Update layout 

Connect activity 
Write logic 



If the method doesn’t take this form, the method won’t respond 
when the user touches the button. This is because behind the 
scenes, Android looks for a public method with a void return value, 
with a method name that matches the method specified in the 
layout XML. 

The View parameter in the method may seem unusual at first 
glance, but there’s a good reason for it being there. The parameter 
refers to the GUI component that triggers the method (in this case, 
the button). As we mentioned earlier, GUI components such as 
buttons and text views are all types of View. 

So let’s update our activity code. Add the onClickFindBeer ( ) 
method below to your activity code: 



II you want a method 
to respond to a button 
click, it must he public, 
kave a void return 
type, and take a single 
View parameter. 



Were usihg this 

£lass, so we heed — a ■ . , . , 

www import android . view . 

to import it 



View; 



public class FindBeerActivity extends Activity { 

Add the 

Oh ChfckFihdBee*-0 ’ 

method “to /Call when the user clicks the button 

FihdBcerA^tvi'ty-java- — public void onClickFindBeer (View view) { 

h 



□ 

BeerAdviser 

4H 

app/sre/main 

L a 



<Layout> 

</Layout> 

activity_find_beer.xml 



onClickFindBeerQ 






java 



LQ 



com.hfad.beeradviser 

LQ 



O 



FlndBeerActivity.java 



FindBeerActivity.java 
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onClickFindPeerO needs to do something 

Now that we’ve created the onClickFindBeer ( ) method in our 
activity, the next thing we need to do is get the method to do something 
when it runs. We need to get our app to display a selection of different 
beers that match the beer type the user has selected. 

In order to achieve this, we first need to get a reference to both the spinner 
and text view GUI components in the layout. This will allow us to retrieve 
the value of the chosen beer type from the spinner, and display text in the 
text view. 



building interactive apps 




Create project 
Update layout 
Connect activity 
Write logic 



Use findView&yId() to get a reference to a view 



We can get a handle for our two GUI components using a method called 
f indViewByld ( ) . The f indViewByld ( ) method takes the ID of 
the GUI component as a parameter, and returns a View object. You then 
cast the return value to the correct type of GUI component (for example, 
a TextView or a Button). 

Here’s how you’d use f indViewByld ( ) to get a reference to the text 
view with an ID of brands: 



1/Vc want the View with 

an IP o-f brands. 




TextView brands = (TextView) f indViewByld (R. id. brands ) ; 

\ f 

bvands is a TextView, so we 
have to east it as one. 



Take a closer look at how we specified the ID of the text view. Rather than 
pass in the name of the text view, we passed in an ID of the form 
R . id . brands. So what does this mean? What’s R? 

R.java is a special Java file that gets generated by the Android tools 
whenever you create or build your app. It lives within the app /build/ 
generated/ source/r/ debug folder in your project in a package with the same 
name as the package of your app. Android uses R to keep track of the 
resources used within the app, and among other things it enables you to 
get references to GUI components from within your activity code. 

If you open up R.java , you’ll see that it contains a series of inner classes, 
one for each type of resource. Each resource of that type is referenced 
within the inner class. As an example, R includes an inner class called id, 
and the inner class includes a static final brands value. The line 
of code 



(TextView) f indViewByld (R . id . brands ) ; 
uses this value to get a reference to the brands text view. 



R is a special Java class 
that enables you to 
retrieve relerences to 
resources in your app. 

o 



R.java gets 
generated 
for you. 

You don’t 
change any of the code within 
R, but it’s useful to know it’s 
there. 




you are here ► 
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view methods 



Once you have a View, you can access its 
methods 

The f indViewByld ( ) method provides you with a Java version of your 
GUI component. This means that you can get and set properties in the 
GUI component using the methods exposed by the Java class. Let’s take a 
closer look. 

Setting the text in a TextView 

As you’ve seen, you can get a reference to a text view in Java using 

TextView brands = (TextView) findViewByld (R . id . brands ) ; 

When this line of code gets called, it creates a TextView object called 
brands. You are then able to call methods on this TextView object. 

Let’s say you wanted to set the text displayed in the brands text view 
to “Gottle of geer”. The TextView class includes a method called 
set Text ( ) that you can use to change the text property. You use it like 
this: 

brands . setText ("Gottle of geer"); rfc brands 

Te*tl/iew to qottle o\ jeer 

Retrieving the selected value in a spinner 

You can get a reference to a spinner in a similar way to how you get a 
reference to a text view. You use the findViewByld ( ) method as before, 
only this time you cast the result as a Spinner: 

Spinner color = (Spinner) f indViewByld (R . id .color); 



y/ Create project 

^ Update layout 

\/ Connect activity 
Write logic 



This gives you a Spinner object whose methods you can now access. 
As an example, here’s how you retrieve the currently selected item in the 
spinner, and convert it to a String: 



String . valueOf (color . getSelectedltem ( ) ) 

The code 



This (jets "the selected i-tem in a 
spinney- and £onvev~fcs ij Jo a Sjv-inj. 



color . getSelectedltem ( ) 



actually returns a generic Java object. This is because spinner values can 
be something other than Strings, such as images. In our case, we know 
the values are Strings, so we can use String. valueOf ( ) to convert 
the selected item from an Ob j ect to a String. 
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Update the activity code 

You now know enough to write some code in the onClickFindBeer () 
method. Rather than write all the code we need in one go, let’s start by 
reading the selected value from the spinner, and displaying it in the text view 

Activity Magnets 

Somebody wrote a new onClickFindBeer () method using fridge magnets 
for us to slot into our activity. Unfortunately, a freak kitchen whirlwind has 
dislodged the magnets. Can you piece the code back together again? 

The code needs to retrieve the type of beer selected in the spinner, and then 
display the type of beer in the text view. 

//Call when the button gets clicked 
public void onClickFindBeer ( view) { 



//Get a reference to the TextView 

brands = ( ) ; 



//Get a reference to the Spinner 

Spinner = ( ) ; 



//Get the selected item in the Spinner 
String = String . valueOf (color . 



//Display the selected item 
brands. (beerType) ; 

} 






) ; 



TextView 



color 



C 



(TextView) 



| findViewByld 1 


l 


setText | 


i 






R . view . brands 



R. id. color 



You v/oh^t 
need to use 



R. id. brands 1 ^7 all of the 







1 T3 vi ew . color 1 


1 1 r 




View 

1 1 


[ getSelectedltem^^^ [ 


beerType 


(Spinner) | 








findViewById~j 
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magnets solution 






Activity Magnets Solution 

Somebody wrote a new onClickFindBeer ( ) method using 
fridge magnets for us to slot into our activity. Unfortunately, a freak 
kitchen whirlwind has dislodged the magnets. Can you piece the 
code back together again? 



The code needs to retrieve the type of beer selected in the spinner, 
and then display the type of beer in the text view. 



//Call when the button gets clicked 



public void onClickFindBeer ( j view | view) { 
//Get a reference to the TextView 



TextView j brands = (TextView) 



f indViewByld 



R . id . brands 



T 



1 color 


1 = ] 


(Spinner) 1 





f indV iewByld 



R. id. color | ) . 



//Get the selected item in the Spinner 

String beerType \ = String . valueOf ( color . |~ getSelectedltemQ 




) ; 



//Display the selected item 
brands. setText I (beerType) ; 



Button 





R- view. brands j didn't need b> use 

’ -bhese 
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The first version of the activity 

Our cunning plan is to build the activity in stages, and test it as we go 
along. In the end, the activity will take the selected value from the spinner, 
call a method in a custom Java class, and then display matching types of 
beer. For this first version, our goal is just to make sure that we correctly 
retrieve the selected item from the spinner. 



building interactive apps 
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Here is our activity code, including the method you pieced together on 
the previous page. Apply these changes to FindBeerActivity.java , then save 
them: 



package com. hfad.beeradviser; 



import 

import 

import 

import 

import 



android . os . Bundle ; 
android . app . Activity; 

android . view . Vi 
android . widget . 
android . widget . 






Spinner; ^^WlcVe wsmj these 
TextView : tF e *'k r3 tUsses- 



public class FindBeerActivity extends Activity { 



□ 

BeerAdviser 

4H 

app/src/main 

41 

java_ 

LQ 

com. hfad.beeradviser 

LQ 



FindBeerActivity.java 



@Override 

protected void onCreate (Bundle savedlnstanceState) { \Ntvt noj dbanged -this method 
super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_f ind_beer ) ; 

} 



//Call when the button gets clicked 
public void onClickFindBeer (View view) { 

//Get a reference to the TextView 

TextView brands = (TextView) f indViewBy Id (R. id. brands ) ; -C’md\/»ewBy|d returns a 

//Get a reference to the Spinner ^ \/iew. You need Jo ddst Vt 

Spinner color = (Spinner) findViewByld (R. id. color) ; Jo the ri^bj "type \/>ew. 

//Get the selected item in the Spinner 

String beerType = String. valueOf (color .getSelectedl tern ()) ; 

//Display the selected item 
brands . setText (beerType) ; 

} 

} 



•jv, UC rn 

returns an Object- 
You need Jo turn ij 
injo a String 
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what happens 



What the code does 

Before we take the app for a test drive, let’s look at what the code 
actually does. 




Create project 
Update layout 
Connect activity 
Write logic 



Q The user chooses a type of beer from the spinner and clicks on the Find Beer button. 
This calls the public void onClickFindBeer(View) method in the activity. 

The layout specifies which method in the activity should be called when the button is clicked via the 
android: onClick property of the button. 




Layout FindBeer Activity 



o 



The activity gets references to the TextView and Spinner GUI components using calls 
to the findViewByldQ method. 



Spinner 



FindBeerActivity 

TextView 






o 



The activity retrieves the currently selected value of the spinner, and converts it to a 
String. 




FindBeerActivity Spinner 



O 



The activity then sets the text property of the TextView to reflect the currently 
selected item in the spinner. 



"amber" 




FindBeerActivity TextView 



64 Chapter 2 



building interactive apps 



Test drive the changes 



Make the changes to the activity file, save it, and then run 
your app. This time when we click on the Find Beer button, it 
displays the value of the selected item in the spinner. 

The type o( beev selected is 
displayed m the text view- 




there, are no 

Dumb Questions 



% I added a string to my strings.xml file but I can’t see it in 
R.java. Why isn’t it there? 



Android Studio, generates R.java when you save any 
changes you’ve made. If you’ve added a resource but can’t see it in 
R.java, check that your changes have been saved. 




In this case? Isn’t it always? 



You can do more complicated things with spinners than just 
display text. As an example, the spinner might display an icon 
next to each value. As getSelectedltem ( ) returns an 
Ob j ect, it gives you a bit more flexibility. 



R.java also gets updated when the app gets built. The app builds 
when you run the app, so running the app will also update R.java. 

Qj The values in the spinner look like they’re static as 
they’re set to the values in the string-array. Can I 
change these values programmatically? 

You can, but it’s more complicated than just using static 
values. We’ll show you later in the book how you can have 
complete control over the values displayed in components such as 
spinners. 



% What type of object is returned by 
getSelectedltem ( ) ? 



It’s declared as type Object. Because we used a 
string-array for the values, the actual value returned in 
this case is a String. 




Does the name of onClickFindBeer matter? 



All that matters is that the name of the method in the activity 
code matches the name used in the button’s onClick attribute 
in the layout. 



% Why did we replace the activity code that Android Studio 
created for us? 



IDEs such as Android Studio include lots of time-saving 
functions and utilities that can save you a lot of time. They generate 
a lot of code for you, and sometimes this can be useful. When 
you’re learning a new language or development area such as 
Android, we think it’s best to learn about the fundamentals of the 
language rather than what the IDE generates for you. This way 
you’ll develop a greater understanding of it, which you’ll then be 
able to use no matter which IDE you use. 
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BeerExpert 



Building the custom Java class 



As we said at the beginning of the chapter, the Beer Adviser app 
decides which beers to recommend with the help of a custom 
Java class. The custom Java class is written in plain old Java, with 
no knowledge of the fact it’s being used by an Android app. 



Custom Java class spec 

The custom Java class should meet the following requirements: 



o 

o 

o 



The package name should be com. hf ad . beer adviser. 

The class should be called BeerExpert. 

It should expose one method, getBrands ( ) , that takes a 
preferred beer color (as a String), and return a List<String> of 
recommended beers. 




strings.xml 



Activity 

tVe need bo Cxtdbt 

a Java dlass that 

r»biit ...| x the activity dan 

use to -f ind out 
u/hidh beev- brands 
to surest- 




BeerExpert 



Puild and test the Java class 

Java classes can be extremely complicated and involve calls to complex 
application logic. You can either build and test your own version of the 
class, or use our sophisticated version of the class shown here: 



□ 



BeerAdviser 



4 U 

app/sre/main 



package com. hfad. beeradviser ; 
import j ava . util . ArrayList; 
import j ava . util . List ; 



L CZ 1 



java 



This is pure Java code, 
nothing A^droidy about it 



■ 



com. hfad. beeradviser 

Lu 



public class BeerExpert { 

List<String> getBrands (String color) { 

List<String> brands = new ArrayList<String> ( ) ; 
if (color . equals ( "amber" ) ) { 

brands . add ( "Jack Amber"); 
brands . add ( "Red Moose" ) ; 

} else { 

brands . add ( "Jail Pale Ale") 
brands . add ( "Gout Stout" ) ; 



Y 

r 



BeerExpert.java 

Y 



Ra tils! 



} 

return brands; 



Add the BeerExpert class to your project. 
Highlight the com.hfad.beeradviser 
package in the applsrclmainljava 
folder, and go to File->New...-sJava 
Class. A new class will be created in the 
package. 
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Enhance the activity to call the custom 
Java class so that we can get REAL advice 

In version two of the activity we need to enhance the onClickFindBeer() 
method to call the Beer Expert class for beer recommendations. The code 
changes needed are plain old Java. You can try to write the code and run the 
app on your own, or you can turn the page and follow along. 



building interactive apps 




Create project 
Update layout 
Connect activity 
Write logic 




Enhance the activity so that it calls the BeerExpert 
getBrands ( ) method and displays the results in the text view. 



package com. hfad. beeradviser; 



import android . os . Bundle; 
import android . app . Activity; 
import android . view . Menu; 
import android . view . View; 
import android . widget . Spinner ; 
import android . widget . TextView; 

import java. util. List; ^ added ^his | me yo*, 

public class FindBeerActivity extends Activity { 

private BeerExpert expert = new BeerExpert ( ) , 



You II need bo use -the 
Beeir£*pe\rt dass bo get ihe 
beev v-e£onr\rnenda‘tions, so we 
added -this line (or you boo . 



//Call when the button gets clicked 
public void onClickFindBeer (View view) { 

//Get a reference to the TextView 

TextView brands = (TextView) findViewByld (R . id . brands ) ; 
//Get a reference to the Spinner 

Spinner color = (Spinner) findViewByld (R . id . color ) ; 

//Get the selected item in the Spinner 

String beerType = String . valueOf (color . getSelectedltem ()) ; 




update the ohCliekFmdBeevO 



''C'tbod- 
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Enhance the activity so that it calls the BeerExpert 
getBrands ( ) method and displays the results in the text view. 



package com. hfad. beeradviser; 

import android . os . Bundle; 
import android . app . Activity; 
import android. view. Menu; 
import android. view. View; 
import android . widget . Spinner ; 
import android . widget . TextView; 
import java. util .List; 



public class FindBeerActivity extends Activity { 

private BeerExpert expert = new BeerExpert () ; 



//Call when the button gets clicked 
public void onClickFindBeer (View view) { 

//Get a reference to the TextView 

TextView brands = (TextView) findViewByld (R . id . brands ) ; 
//Get a reference to the Spinner 

Spinner color = (Spinner) findViewByld (R . id . color ) ; 

//Get the selected item in the Spinner 

String beerType = String . valueOf (color . getSelectedltem ( ) ) ; 



/ / £jet recommendations -from the Beer£%per* t class 

List<£tring> brandsList =• e^pert-getBrandsfbeerT ype); fc{ a List o( bv-a^ds 



£trin<)Builder brandsFormatted =• new StringBuilderO; ^ " Build a String using 

the values in the List- 

{or (String brand : brandsList) { 

brandsFormattedappend(brand)append('\n ); ^ — ' P* ,s ?' a Y each brand 

on 3 new line- 



/ /Display -the beers 

brayids.setTe*t(bra*dsForrnatted^ th/lexi lew. ^ 



} 



} 



IXsinA bbe Beer£*peri retires pure Java Code, so Aon i 
W orry 1 your tode looks a little di&erent than ours. 
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Activity code version l 

Here’s our full version of the activity code. Apply the changes to 
your version of FindBeerActivity.java, make sure you’ve added the 
BeerExpert class to your project, and save your changes: 



building interactive apps 




Create project 
Update layout 
Connect activity 
Write logic 



package com.hfad.beeradviser; 

import android. os . Bundle; 

import android . app . Activity ; 

import android . view . Menu; 

import android . view . View; 

import android . widget . Spinner ; 

import android. widget . TextView; 

import java. util. List Were using this extra class. 

public class FindBeerActivity extends Activity { 

private BeerExpert expert = new BeerExpert ( ) ; 



□ 

BeerAdviser 

4T3 

app/src/main 

Hn 

java_ 

com.hfad.beeradviser 

LQ 



FindBeerActivity.java 



Add an instance o£ BeerExpert as a private variable. 

QOverride 

protected void onCreate (Bundle savedlnstanceState ) { 

super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_f ind_beer ) ; 

} 



//Call when the button gets clicked 
public void onClickFindBeer (View view) { 

//Get a reference to the TextView 

TextView brands = (TextView) f indViewByld (R . id . brands ) ; 

//Get a reference to the Spinner 

Spinner color = (Spinner) findViewByld (R. id. color ) ; 

//Get the selected item in the Spinner 

String beerType = String . valueOf (color . getSelectedltem ()) ; 

//Get recommendations from the BeerExpert class 

List<String> brandsList = expert . getBrands (beerType) ; 

StringBuilder brands Formatted = new StringBuilder () ; 

for (String brand : brandsList) { ^ . 

brands Formatted . append (brand) . append ( ' \n ' ) ; ,S ^ ^ 

^ tat\\ brand on d new line 

//Display the beers 

brands . setText (brands Formatted) ; Display the String in the Textl/W 




Wse the BeerExpert class 
to get a List ot brands. 
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what happens 



What happens when you run the code 

Q) When the user clicks on the Find Beer button, the 
onClickFindBeer() method in the activity gets called. 

The method creates a reference to the spinner and text view, and gets the 
currently selected value from the spinner. 




o 

TextView 



O The onClickFindBeer() calls the getBrands() method in the 

BeerExpert class, passing in the type of beer selected in the 
spinner. 

The getBrands ( ) method returns a list of brands. 



getBrands ("amber") 




FindBeerAc+ivi+y "Red Moose" BeerExpert 



^ The onClickFindBeer() method formats the list of brands and 
uses it to set the text property in the text view. 



"Jack Amber 




FindBeerAc+ivi+y 



TextView 
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Test drive your app 

Once you’ve made the changes to your app, go ahead 
and run it. Try selecting different types of beer and 
clicking on the Find Beer button. 




building interactive apps 

Create project 
Update layout 
Connect activity 
Write logic 




of suitable beers. 
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71 





toolbox 




Your Android Toolbox 

You’ve got Chapter 2 under 
your belt and now you’ve 
added building interactive 
Android apps to your toolbox. 



You can download 
•tine -full tode -for 
■the Chapter £v-om 

Vn-t-bps://-t'm7wvl-Cow»/ 

rteadF'irstA'ndroid- 






BULLET POINTS 



The Button element is used to add a button. 

The Spinner element is used to add a spinner. A spinner is a drop-down list 
of values. 

All GUI components are types of view. They inherit from the Android view 
class. 

Add an array of string values using: 

<string-array name="array"> 

<item>stringl</ item> 

</ string-array> 

Reference a string-array in the layout using: 

"Sarray/ array_name" 

Make a button call a method when clicked by adding the following to the layout: 

android: onClick="clickMethod" 



There needs to be a corresponding method in the activity: 

public void clickMethod (View view) { 

} 

■ R.java is generated for you. It enables you to get references for layouts, GUI 
components, Strings, and other resources in your Java code. 

■ Use f indViewByid ( ) to get a reference to a view. 

■ Use setText ( ) to set the text in a view. 

■ Use getselecteditem ( ) to get the selected item in a spinner. 

■ Add a custom class to an Android project by going to File 
menu— >New...— >Java Class. 
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3 multiple activities and intents 




I sent an intent asking who 
could handle my ACTION_CALL, 
and was offered all sorts of 
activities to choose from. 



State Your Intent 




Most apps need more than one activity. 

So far we’ve just looked at single-activity apps, which is fine for simple apps. But when 
things get more complicated, just having the one activity won’t cut it. We’re going to show 
you how to build apps with multiple activities, and how you can get your apps talking 
to each other using intents. We’ll also look at how you can use intents to go beyond the 
boundaries of your app and make activities in other apps on your device perform 
actions. Things just got a whole lot more powerful... 



this is a new chapter 



tasks 



Apps can contain more than one activity 



Earlier in the book, we said that an activity is a single, defined thing 
that your user can do, such as displaying a list of recipes. If your 
app is simple, this may be all that’s needed. 

A lot of the time, you’ll want users to do more than just one thing — 
for example, adding recipes as well as displaying a list of them. 

If this is the case, you’ll need to use multiple activities: one for 
displaying the list of recipes and another for adding a single recipe. 

The best way of seeing how this works is to see it in action. You’re 
going to build an app containing two activities. The first activity will 
allow you to type a message. When you click on a button in the first 
activity, it will launch the second activity and pass it the message. 
The second activity will then display the message. 



An activity is a single 
focused tiling your user 
can do. If you chain 
multiple activities together 
to do something more 
complex, it’s called a task. 



The -Pirs-t a^iivi-ty le-fcs^^ 
you en-ter a message- 



SEND MESSAGE 



A little message! 



A little message 



When you dlidk on -the Send 
button in the -first activity, 
it passes the message to the 
sedond activity- The sedond 
adtivity gets displayed on top 
o-P the -first and displays the 
message- 



Here are the steps ^ 

Q) Create a basic app with a single activity and layout, 
o Add a second activity and layout. 

^ Get the first activity to call the second activity. 

Q Get the first activity to pass data to the second activity. 
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multiple activities and intents 



Here's the app structure 



The app contains two activities and two layouts. 



© 



When the app gets launched, it starts activity 
CreateMessage Activity . 

This activity uses the layout activity_create_message.xml. 



0 



The user clicks on a button in CreateMessage Activity. 

This launches activity ReceiveMessageActivity, which uses layout 
activity _ receive_ message, xm l. 




activity_create_message.xml 

’Tex.'t errlev-ed via 

Cvca* 

is 'tvanS'fcvvcd *to 

\ RcdcWcMcssayA^'t^i'ty- 



activity_receive_message.xml 



9 4 



-J 




Device 



CreateMessageActivity.java 



v \ 



ReceiveMessageActivity.java 



Create the project 

You create a project for the app in exactly the same way you 
did in previous chapters. Create a new Android Studio project 
for an application named “Messenger” with a package name 
of com . hf ad . messenger. The minimum SDK should be 
API 1 5 so that it will work on most devices. You’ll need a blank 
activity called “CreateMessageActivity” with a layout called 
“activity_create_message” so that your code matches ours. 

On the next page, we’ll update the activity’s layout. 



Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 
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update layout 



Update the layout 

Here’s the XML for the activity_create_message.xml file. We removed the 
<TextView> that Android Studio created for us, and replaced it with 
<Button> and <EditText> elements. The <EditText> element gives 
you an editable text field you can use to enter data. 

Change your activity _create_mes sage. xml file to match the XML here: 



□ 

Messenger 

LQ 

app/src/main 

Hr 3 



res 



MD 



layout 




activity_create_ 

<RelativeLayout xmlns : android="http : // schemas . android . com/ apk/ res/ android" message.xml 



xmlns : tools="http : / / schemas . android. com/ tools" 



android: layout_width="match_parent " 

android : layout_height="match_parent" 

android : paddingBottom=" 1 6dp" 

android : paddingLef t=" 1 6dp" 

android : paddingRight=" 1 6dp" 

android : paddingTop=" 1 6dp" 

tools : context=" . CreateMessageActivity" > 



Replace the 
<Te*t\/iew> 
/Wv-oi id 
Studio <yves 
you with the 
<Button> a*d 
<6ditTe*t>. 



SEND MESSAGE 



1 



<Button 

android : id=" @+id/send" 
android : layout_width="wrap_content " 
android : layout_height="wrap_content" 
android : layout_alignParentLef t=" true " 
android : layout_alignParentTop= " true " 
android : layou t_marginLef t= " 3 6dp " 
android : layou t_marginTop= " 2 ldp " 

android: onClick="onSendMessage" ' Cliek'm^ oy \ the button v-uns the 
android: text="0string/send" /> onSendAlessajeO method m the activity. 

<EditText 

android : id=" @+id/message 



■'This is a String 
v-esouv-£e. 



android : layou t_width="wrap_con tent " 
android : layou t_height="wrap_con tent" 
android : layout_alignLef t=" @+id/send" 
android : layout_below=" @+id/send" 
android : layou t_marginTop=" 18dp" 
android: ems=" 10" /> 

</RelativeLayout> This des£vibes how wide the <£dit~fe*t> 

should be- It should be wide enough to 
a£dor*r*odate 10 lettev M’s- 



The <EditText> element 
defines an editable text 
field for entering text. It 
inherits from the same 
Android View class as the 
other GUI components 



we ve seen so 



far. 
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Update strings.xwl... 



The button we added has a text value of @string/send. This 
means we need to add a string called “send” to strings. xml and 
give it a value. This value is the text we want to appear on the 
button. Do this now: 



multiple activities and intents 

Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 



□ 

Messenger 



<string name="send">Send Message</string> 

Add a new String 

...and add the method to the activity 



413 

app/src/main 



res 



tailed send- We $ave 
ouvs a value ©-C Send 
Message so that the 
*te%t w Send Message 
appears on the button- 



LQ 

values 



The line in the <Button> element 

android : onClick= ,, onSendMessage n 

means that the onSendMessage ( ) method in the activity 
will fire when the button is clicked. Let’s add this method to the 
activity now. 

Open up the CreateMessageActivity.java file and replace the code 
Android Studio created for you with the following: 

package com. hf ad. messenger; 

WeVe repladin^ *lhe £ode that 

import android. app. Activity; /Wroid Studio treated -for us, 

as most o( the Lode, it Creates 



strings.xml 



import android . os . Bundle ; 
import android. view. View; 



isn’t required- 



public class CreateMessageActivity extends Activity { 

The onCveateO method yts called 



□ 

Messenger 



@ Override 






when -the activity is created- 



protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_create_message) 

} 

//Call onSendMessage () when the button is clicked 



43 

app/src/main 



java 



413 



com. hfad. messenger 

L § 

CreateMessage 

Activity.java 



public void onSendMessage (View view) { -n, . , , , 

^"Th.s method will get called when the 

> button's clicked- Well Complete the method 

} body as we work our way through the rest 

o+ the chapter. 

Now that you’ve created the first activity, let’s move on to the 
second. 
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Create the second activity and layout 

Android Studio has a wizard that lets you add extra activities and layouts to 
your apps. It’s like a cut-down version of the wizard you use to create an app, 
and you use it whenever you want to create a new activity 

To create the new activity choose File — > New — > Activity and choose the 
option for Blank Activity You will be presented with a new screen where you 
can choose options for your new activity 

Every time you create a new activity and layout, you need to name them. 
Give the new activity a name of “ReceiveMessageActivity” and the layout a 
name of “activity_receive_message”. Check that the package name is “com. 
hfad.messenger”. Accept the rest of the defaults, and when you’re done, click 
on the Finish button. 




Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 




frtuyi the 
vest o( the 
defaults, as all 
weVe interested 
in is treating 

a new activity 
and layout- Well 
reflate most 
the tode 
Android Studio 
cyves us. 
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multiple activities and intents 



What just happened? 

When you clicked on the Finish button, Android Studio 
created a shiny new activity file for you, along with a new 
layout. If you look in the explorer, you should see that a new 
file called ReceiveMessageActivity.java has appeared in the app/ 
src/main/java folder, and a file called activity _receive_mes sage, 
xml has appeared under app /src /main/res /layout. 



Wcrcs the new activity and layout we just created- 
There are now two activities and layouts in the app* 



Each activity uses a different layout. 
CreateMessageActivity uses the layout activity _ 
create_message.xml , and ReceiveMessageActivity 
uses the layout activity _receive_mes sage. xml. 



<Layou-t> 

</Layou-t> 

activity_receive_message.xml 



IM 





activity_create_message.xml 




/ 




CreateMessageActivity.java RecieveMessageActivity.java 



Behind the scenes, Android Studio also made a configuration 
change to the app in a file called AndroidManifest. xml. Let’s 
take a closer look. 



e o o 



□ activity. 



d m 0 






Messenger f app 
E I h Project 



© 



He s se nge r /And raldStud ioProjects / Me s s e nge r ) 

► D .idea 

► ED build 
Cl libs 
▼ Cl src 

► DandroidTest 
▼ Dmain 
▼ C java 

Q com. hfad. messenger 

c i Create Message Activity 
4 'fa ReceiveMessageActivity 

Cl res 

B drawable 
▼ B layout 

•= ■ a cti vity_create_m e s sa ge .xm I 
■ activity_receive_me5sage.xml 
Q menu 

B mipmap-hdpi 
B mipmap-mdpi 
Q mipmap-xhdpi 
Q mipmap-xxhdpi 
E] values 

E] values-wSZGdp 
<> AndroidManifest.xml 
0 .gitignore 
m app.iml 
® build. gradle 
0 proguard-rules.pro 

► C gradle 

0 .gitignore 
(5 build. gradle 
Q gradle. properties 
0 grad lew 
0 gradlew.bat 
I local. properties 
ill Messenger.iml 
@ settings, gradle 
#\ E.xternal Libraries 



► 

► 

► 

► 

► 

► 

► 



Terminal 



6: Android 0: Messages % TODO 



Cradle build finished in IS sec (a minute ago) 
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AndroidManifest.xml 



Welcome to the Android manifest file 

Every Android app must include a file called AndroidManifest.xml.You can 
find it in the app /src /main folder of your project. The AndroidManifest.xml 
file contains essential information about your app, such as what activities it 
contains, required libraries, and other declarations. Android creates the file for 
you when you create the app. If you think back to the settings you chose when 
you created the project, some of the file contents should look familiar. 

Here’s what our copy of AndroidManifest.xml looks like: 



Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 



□ 

Messenger 

Mr 3 

AndroidMani-Pest-xml | </ Xml j 

in "this -Polder. AndroidManifest.xml 




look at this later in the 
book. 



Well look at this later. 




Watch it! 



This i< 
the -Pirst 
activity. 
Create 
Message 
Activity 



apps 
without 
an IDE, you’ll 
need to create 
this file manually. 



<?xml version="l . 0" encoding="utf-8 " ?> 

<manifest xmlns : android="http : / / schemas . android. com/ apk/ res/android" 
package="com. hfad. messenger" > ^ — This is the package 

name v/e spedi-Pied- 

application /Wroid Studio gave ouv 

android: allowBackup="true" 3pp 3 de-fault \tor\- We’ll 

android: icon=" @mipmap/ ic_launcher" 
android: label=" ©string/ app_name" 

android: theme= n @style/AppTheme" > ^ — > The theme a-P-Pedts the 

appearance ot the app 

<activity 

android : name=" . CreateMessageActivity" 
android: label=" ©string/ app_name" > 

<intent- filter > 

<action android : name="android . intent . action . MAIN" /> 

<category android: name="android . intent . category. LAUNCHER 
</intent-f ilter> ^ 

_</ activity> TV's says the activity tarv 

This is the 

second <activity 

activity \ android : name=" . ReceiveMessageActivity " 

Redeive J 

Message j android: label="@string/title_activity_receive_message" > 

Adtivity. (</ activity> 

</ application> 

</manifest> 



If you 

develop 

Android 



This bit spedi-Pies 
that it's the main 
adtivity ot the app. 



/> 



be used to laundh the app. 






Android Studio added these lines -Por 
us u/hen y / e added the sedond adtivity. 
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Every activity needs to be declared 

All activities need to be declared in AndroidManifest.xml. If an activity 
isn’t declared in the file, the system won’t know it exists. And if the 
system doesn’t know it exists, the activity will never run. 

You declare an activity in the manifest by including an <activity> 
element inside the <application> element. In fact, every activity 
in your app needs a corresponding <activity> element. Here’s the 
general format: 



If I'm not included in 
AndroidManifest.xml, then 
as far as the system's 
concerned, I don't exist 
and will never run. 



application 



s fcacM activity needs bo be dedaved 
> inside the <app lidation> element- 

<activity This line is mandatory. 

android: name="activity_class_name" ^ JKis IS oftlona | ; 
android: label="@ string/ activity_label" ^ut Andvoid Studio 

• • • ^ dompletes it *fov us. 

> The activity may have other properties too. 



O 

0 




Activity 



</activity> 



</application> 



The following line is mandatory and is used to specify the class name of 
the activity:: 

android : name= n activity_class_name" 

activity_class_name is the name of the class, prefixed with a 
In this case, it’s . ReceiveMessageActivity. The class name 
is prefixed with a because Android combines the class name with 
the name of the package to derive the fully qualtfied class name. 

This line is optional and is used to specify a user-friendly label for the 
activity: 

android : label=" @ string/ activity_label" 

It’s displayed at the top of the screen when the activity runs. If you 
leave this out, Android will use the name of the application instead. 

The activity declaration may include other properties too, such as 
security permissions, and whether it can be used by activities in other 
apps. 




The second 
activity was 

r automatically 

WatCn it! declared 

because we 
added it using the 
Android Studio wizard. 



If you add extra activities 
manually ; you’ll need to edit 
AndroidManifest.xml yourself. 
If you use another IDE , it may 
not be added for you. 
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An intent is a type of message 

So far we’ve created an app with two activities in it, and each activity 
has its own layout. When the app is launched, our first activity, 
CreateMessageActivity, will run. What we need to do next is get 
CreateMessageActivity to call ReceiveMessageActivity 
when the user clicks the Send Message button. 

Whenever you want an activity to start a second activity, you use an intent. 
You can think of an intent as an “intent to do something”. It’s a type of 
message that allows you to bind separate objects (such as activities) together 
at runtime. If one activity wants to start a second activity, it does it by 
sending an intent to Android. Android will start the second activity and 
pass it the intent. 




Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 

You start an activity 
by creating an 
intent and using it 
in the startActivityO 
method. 




You can create and send an intent using just a couple of lines of code. You 
start by creating the intent like this: 

Intent intent = new Intent (this. Target . class) 

The first parameter tells Android which object the intent is from, and 
you can use the word this to refer to the current activity. The second 
parameter is the class name of the activity that needs to receive the intent. 

Once you’ve created the intent, you pass it to Android like this: 



The intent specifies -the activity 
you want to receive it- Its like 
putting an address on an envelope. 



v 



Intent 




To: AnotherActivity 



s tar tActivity (intent) ; 



This tells Android to start the activity specified by the intent. 



startActivityO starts the 
activity speeitied in the intent". 



Once Android receives the intent, it checks everything’s OK and 
tells the activity to start. If it can’t find the activity, it throws an 

ActivityNotFoundException. 




Activityl Android Activity2 
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Use an intent to start the second activity 

Let’s put this into practice and use an intent to call 
ReceiveMessageActivity. We want to launch the activity 
when the user clicks on the Send Message button, so we’ll add the 
two lines of code to our onSendMessage ( ) method. 

Make the changes highlighted below: 



package com. hfad. messenger; 



import android. app .Activity; 

import android . content . Intent ; 

import android. os . Bundle; 
import android. view. View; 



We need to import ■the 
Intent elass 
android Content- Intent 
as weVe using i-t in 
onSendMessageO. 



public class CreateMessageActivity extends Activity { 






We ve not changed this method- 



0Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_create_message ) ; 



□ 

Messenger 

413 

app/sre/main 

413 



java_ 

413 

com. hfad. messenger 



CreateMessage 

Activity.java 



//Call onSendMessage ( ) when the button is clicked 
public void onSendMessage (View view) { 

Intent intent = new Intent (this, ReceiveMessageActivity . class) ; 



startActivity (intent) ; 



Start activity ReceiveMessageActivity. 



} 

So what happens now when we run the app? 
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what happens 



What happens when you run the app 

Before we take the app out for a test drive, let’s go over how the 
app we’ve developed so far will function: 




Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 



© 



When the app gets 
launched, the main activity, 
CreateMessage Activity starts. 

When it starts, the activity specifies 
that it uses layout activity_create_ 
message, xml. This gets displayed in a 
new window. 




Q The user clicks on a button. 

The onSendMessage ( ) method 
in CreateMessageActivity 
responds to the click. 




Device 



onSendMessage () 




CreateMessageActivity 



O The onSendMessage() method 
tells Android to start activity 
ReceiveMessageActivity using 
an intent. 

Android checks that the 
intent is OK, and then it tells 
ReceiveMessageActivity to 
start. 



onSendMessage () 
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The story continues... 

Q When ReceiveMessageActivity 
starts, it specifies that it 
uses layout activity_receive_ 
message. xml and this gets 
displayed in a new window. 



O 



Ifl 



Device 



CreateMessageActivity 







Test drive the app 



Save your changes, and then run the app. CreateMessageActivity 
starts, and when you click on the Send Message button, it launches 
ReceiveMessageActivity. 



v 

v 

-H3 



2C J a 12:37 



SEND MESSAGE 



A little message 






Enter a message, and 

£li£k on -the Send 
Message button. 



K 



Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 



m A M 1 



ReceiveMessageActivity 



Hello world! 

1 A/V>ev> you dli£k on tbe Send 
Message button, tbe activity 
RedeiveMessageA^tivity starts, and its 
activity -fills tbe sdv-een- Tbe te%t in tbe 
layout says w ttello wov-ld!” as this is tbe 
de-fault layout /Wvoid Studio gave us. 
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Pass text to a second activity 

So far we’ve coded CreateMessageActivity to start 
ReceiveMessageActivity when the Send Message button is 
pressed. Next, we’ll get CreateMessageActivity to pass text to 
ReceiveMessageActivity so that ReceiveMessageActivity 
can display it. In order to accomplish this, we’ll do three things: 





Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 




o 

© 

o 



Tweak the layout activity_receive_mes sage. xml so that we 
can display the text. At the moment it’s the default 
layout the wizard gave us. 

Update CreateMessageActivity. xml so that it gets the text 
the user inputs. It then needs to add the text to the 
intent before it sends it. 

Update ReceiveMessageActivity. java so that it displays the 
text sent in the intent. 



activity_create_ activity_receive_ 




CreateMessage 

Activity.java 



RecieveMessage 

Activity.java 



let's start with the layout 

Here’s the activity _receive_mes sage. xml layout that Android Studio 
created for us: 



<RelativeLayout xmlns : android="http : / / schemas . android. com/ apk/ res/ android" 
xmlns : tools="http : / / schemas . android. com/ tools" 
android: layout_width="match_parent" | i| 

android: layout_height="match_parent" Messenger 

android: paddingLef t=" 16dp" 
android : paddingRight=" 1 6dp" 
android : paddingTop=" 1 6dp" 
android : paddingBottom=" 1 6dp" 

tools : context="com. hf ad. messenger . ReceiveMessageActivity" > 



HT3 

app/src/main 

L U 



<TextView jr Here's the 

android: text="@string/hello_world" -te>ck view 'that 

android: layout_width="wrap_content" appears 

android: layout_height="wrap_content" /> layout 

</RelativeLayout> 



LQ 

layout 



activity_receive_ 

message.xml 




We need to make a couple of changes to the layout. We need to give the <Textview> 
element an ID of “message” so that we can reference it in our activity code, and we need to stop 
the String “Hello world!” from appearing. How should we change the layout? Have a go before 
looking at the next page. 
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Update the text view properties 

We need to update a couple of things in the layout. 

First, we need to give the <TextView> element an ID. You 
have to add an ID to any GUI components you need to reference 
in your activity code, as this gives you a way of referencing it in 
your Java code. We also need to stop the text “Hello world!” from 
appearing. 

You can do both these things by updating the layout like this: 



□ 

Messenger 

app/src/main 




activity_receive_ 

message.xml 



<RelativeLayout xmlns : android="http : / / schemas . android. com/ apk/ res/ android" 
xmlns : too ls=" http : / / schemas . android . com/ tools " 
android : layout_width="match_parent" 
android: layout_height="match_parent" 
android : paddingLef t=" 1 6dp" 
android : paddingRight=" 1 6dp" 
android : paddingTop=" 1 6dp" 
android : paddingBottom=" 1 6dp" 

tools : context="com . hf ad . messenger . ReceiveMessageActivity"> 



<Textview ^^This $ ,vcs <Te*tVie>w> an IP o( message- 

android: id="@+id/message" Remove the line that sets the text 

cL'.U ^ '^° i h^/h C 1 1 o_wo\r I d • 

android : layout_width="wrap_content" 
android: layout_height="wrap_content" /> 

</RelativeLayout> 



Rather than delete the code that says 

android : text=" @ string/he llo_world r 

we could have updated strings, xml to give the String 
resource hello_world an empty value. We 
decided not to here as the only text we’ll ever want 
to display in the text view is the message passed to it 
by CreateMessageActivity. 

Now that we’ve updated the layout, we can get to 
work on the activities. 



tliereicire no 

Dumb Questions — 

% Do I have to use intents? Can’t I just construct an 
instance of the second activity in the code for my first 
activity? 

That’s a good question, but no, that’s not the “Android 
way” of doing things. One of the reasons is that by passing 
intents to Android, Android knows the sequence in which 
activities are started. This means that when you click on the 
Back button on your device, Android knows exactly where to 
take you back to. 
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putExtraO puts extra information in an intent 

You’ve seen how you can create a new intent using 




Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 



Intent intent = new Intent (this. Target . class ) ; 



You can add extra information to this intent that can be picked up by 
the activity you’re targeting so it can react in some way To do this, you 
use the putExtra ( ) method 

intent .putExtra ("message" , value) ; 

where message is a String name for the value you’re passing in, and 
value is the value. The putExtra ( ) method is overloaded so 
value has many possible types. As an example, it can be a primitive 
such as a boolean or int, an array of primitives, or a String. You 
can use putExtra ( ) repeatedly to add numerous extra data to the 
intent. If you do this, make sure you give each one a unique name. 

How to retrieve extra information from an intent 

The story doesn’t end there. When Android 
tells ReceiveMessageActivity to start, 
ReceiveMessageActivity needs some way of retrieving the 
extra information that CreateMessageActivity sent to Android 
in the intent. 



pui£x-t raO lets 
you put extra 
in-formation in 
the message 
youVe sending. 



Intent 




V, To: ReceiveMessageActivity 






message: "Hello!" 




There are many di£Peren*t options 
-for the type cT value- You 
ean see them all in the 6\ oogle 
Android documentation. Android 
Studio will give you a list as you 
type Code in too. 



There are a couple of useful methods that can help with this. The first 
of these is 



getlntent() ; 



get Intent ( ) returns the intent that started the activity, and you can 
use this to retrieve any extra information that was sent along with it. 

How you do this depends on the type of information that was sent. As 
an example, if you know the intent includes a String value with a name 
of “message”, you would use the following: 

G\t{, -the in-tent 

Intent intent = getlntent ( ) ; ^ 

String string = intent . gets tringExtra ( "message” ) 

You’re not just limited to retrieving String values. As an example, you 
can use 



Intent 




To: ReceiveMessageActivity 
message: "Hello!" 

; 

'* -the s-tring passed along 

wiih -the inien-t -that has a 
name of “message” 



int intNum = intent . getlntExtra ("name” , default_value) ; 



to retrieve an int with a name of name, def ault_value specifies 
what int value you should use as a default. 
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package com. hfad. messenger; 



Poo] Puzzje 



import 

import 

import 

import 



public 



android . os . Bundle ; 
android . app . Activity; 
android . content . Intent; 
android . view .View; 



class 




Your job is to take code segments from 
the pool and place them into the 
blank lines in CreateMessageActivity. 
java. You may not use the same 
code segment more than once, 
and you won't need to use all 
the code snippets. Your goal is to 
make the activity retrieve text from 
the message <EditText> and add it 
to the intent. 



CreateMessageActivity extends Activity { 



@Override 

protected void onCreate (Bundle savedlnstanceState ) { 

super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_create_message) ; 

} 

//Call onSendMessage ( ) when the button is clicked 
public void onSendMessage (View view) { 



Intent intent = new Intent (this, ReceiveMessageActivity . class ) ; 
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pool solution 



package com. hfad. messenger; 

import android . os . Bundle; 
import android . app .Activity; 
import android . content . Intent ; 
import android . view .View; 

j.!T».P.Qrt an droid, wi.d get .Edit Text;. 



V^ou need to import 
-the EditText dlass. 




public class CreateMessageActivity extends Activity { 



Pdd] puzz]c 

Your job is to take code segments from 
the pool and place them into the 
blank lines in CreateMessageActivity. 
java. You may not use the same 
code segment more than once, 
and you won't need to use all 
the code snippets. Your goal is to 
make the activity retrieve text from 
the message <EditText> and add it 
to the intent. 



@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_create_message) ; 

} 



//Call onSendMessage ( ) when the button is clicked 
public void onSendMessage (View view) { 

EditText messageView = (EditText) findViewByld(R. id. message); 

String messageText = messageView.getText().toString(); ^ 



£jet the te*t 
•fv-om the editable 
text -f ield with a* 
IP o-f message- 



intent intent = new Intent (this, ReceiveMessageActivity . class ) , 

intent. putExt (" ^age" messageText); 

startActivity (intent ) ; ^ Ajl i > . ». . 

v ndd the text to the intent 

giving it a name o-f w message” 



These £ode snippets 
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Update the CreateMessageActivity code 

We updated our code for CreateMessageActivity.java so that it 
takes the text the user enters on the screen and adds it to 
the intent. Here’s the full code (make sure you update your 
code to include these changes, shown in bold): 



y/ Create 1 st activity 

” Create 2nd activity 

” Call 2nd activity 
Pass data 



package com. hfad. messenger; 

import android. os . Bundle; 
import android . app . Activity; 
import android . content . Intent ; 
import android. view. View; 



□ 

Messenger 



You need to impov*t “the EdrfcTfe'rtt 

, . ^ — dass andv-oidwidgetEditle^l as 

import android. widget .EditText;*"^* > . , . .1 . 1 

youVe using it in youv- activity tode. 

public class CreateMessageActivity extends Activity { 



K3 

app/sre/main 



4n 



java 



m3 



com, hfad. messenger 



CreateMessage 

0Override Activity.java 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_create_message) ; 

} 



//Call onSendMessage ( ) when the button is clicked th^Ed^T^t 

public void onSendMessage (View view) { ^ 

EditText messageView = (EditText) findViewByld (R. id. message) ; 

String messageText = messageView. getText () .toStringO ; 

Intent intent = new Intent (this, ReceiveMessageActivity . class) ; 
intent . putExtra (ReceiveMessageActivity . EXTRA MESSAGE , messageText) ; 




startActivity (intent) ; 

'T 

Start Redeive/WessajeAt-tivi-ty 
with the intent- 



Now that CreateMessageActivity has added 
extra information to the intent, we need to retrieve the 
information and use it. 



Cvea* te 3ft in'ten*t> 'then add the te*t 
*to *the intent We Ye using a dons-tarrt 
( ov -the name o-f -the e%tva imfov-maton 
so that we know CveateM essage Activity 
and RedeiveMessageA^tWity ave using 
•the same String. Well add this to 
RedeiveMessageA^tivity the ne%* t page- 
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getStringExtraQ 



(ret ReceiveMessageActivity to use 
the information in the intent 




Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 



Now that we’ve changed CreateMessageActivity to add 
text to the intent, we’ll update ReceiveMessageActivity 
so that it uses the text. 

We’re going to get ReceiveMessageActivity to display 
the message in its text view when the activity gets created. As the 
activity’s onCreate () method gets called as soon as the activity 
is created, we’ll add the code to this method. 

To get the message from the intent, we’ll first get the intent using 
the getlntent () method, then get the value of the message 
using getStringExtra ( ) . 

Here’s the full code for ReceiveMessageActivity.java (replace the code 
that Android Studio generated for you with this code, and then 
save all your changes): 




CreateMessage 

Activity.java 



RecieveMessage 

Activity.java 

f 

I/Ve need to make 

RedeiveAlessageA^tivity 
deal with "the intent it 
receives. 



package com. hf ad. messenger ; 
import android . os . Bundle ; 

import android. app. Activity; , 

.We need ho import 

import android . content . Intent ; latent dud 

import android, widget .Tex tView; r~ "fcx.'tX/’iCw classes. 

public class ReceiveMessageActivity extends Activity { 



□ 

Messenger 

4^3 

app/src/main 

Hr 3 

java_ 

4T3 

com . hfad . messenger 



public static final String EXTRA MESSAGE = "message"; 

This is -the name ot the e*tva value we've passing in -the intent 

@ Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setCon ten tView (R. layout . activity_receive_message) ; 

Intent intent = getlntent () ; 

String messageText = intent . getStringExtra (EXTRA_MESSAGE) ; 
TextView messageView = (TextView) findViewByld (R. id. message) ; 



ReceiveMessage 

Activity.java 



^t{ -the intent, and get 
•the message -fv-om it using 
getStv-i ngExtv-aO. 



messageView. setText (messageText) ; 

> 

} Add the text to the message text view. 



Before we take the app for a test drive, let’s run through what the 
code does. 
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What happens when the user clicks the Send Message button 



© 



When the user clicks on the 
button, the onSendMessage() 
method is called. 

Code within the onSendMessage ( ) 
method creates an intent to start activity 
ReceiveMessageActivity, adds 
a message to the intent, and passes it to 
Android with an instruction to start the 
activity 



onSendMessage () 

f 



Intent 




To: ReceiveMessage 
Activity 

CreateMessageActivity message:"Hi!" 



im 



w 

Android 



o 



Android checks that the 
intent is OK, and then tells 
ReceiveMessageActivity to start. 



O 



CreateMessageActivity 



Intent 





To: ReceiveMessage 

Activity 

message:"Hi!" 



And 

or jo 

w 

Android 



ReceiveMessageActivity 



o 



When ReceiveMessageActivity 
starts, it specifies that it uses 
layout activity_receive_message 
xm/, and this gets displayed on 
the device. 

The activity updates the layout so that 
it displays the extra text included in the 
intent. 





Device 



CreateMessageActivity 




activity_receive_message 
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test drive 




Test drive the app 

Make sure you’ve updated the two activities, save your changes, and 
then run the app. CreateMessageActivity starts, and when you 
enter some text and click on the Send Message button, it launches 
ReceiveMes sage Activity. The text you entered is displayed in the 
text view. 



v 

V 

v/ 

-Hv 



Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 




We can change the app to send messages to other people 



Now that we have an app that sends a message to another activity, we 
can change it so that it can send messages to other people. We can do 
this by integrating with the message sending apps already on the device. 
Depending on what apps the user has, we can get our app to send messages 
via Messaging, Gmail, Google +, Facebook, Twitter... 



Hey, hold it right there! That 
sounds like a freaky amount of 
work to get the app working with 
all those apps. And how the heck 
do I know what apps people have 
on their devices anyway? Get real. 



It’s not as hard as it sounds due to the way Android is 
designed to work. 

Remember right at the beginning of the chapter when we said that tasks 
are multiple activities chained together? Well, you’re not just limited 
to using the activities within your app. You can go beyond the 
boundaries of your app to use activities within other apps as well. 
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How Android apps work 

As you’ve seen, all Android apps are composed of one or more 
activities, along with other components such as layouts. Each 
activity is a single defined focused thing the user can do. As an 
example, apps such as Gmail, Google +, Messaging, Facebook, and 
Twitter all have activities that enable you to send messages, even 
though they may achieve this in different ways. 



Device 




£adb app is dor* posed o - f a 
bundb or adtivrlies. Tbeve 
are o*tber Components too, 
but weVe just -Podusin^ on 
tbe activities vi^bt now- 



Intents can start activities in other apps 



You’ve already seen how you can use an intent to start a second 
activity within the same app. The first activity passes an intent 
to Android, Android checks it, and then Android tells the second 
activity to start. 



The same principle applies to activities in other apps. You get an 
activity in your app to pass an intent to Android, Android checks it, 
and then Android tells the second activity to start even though it’s in 
another app. As an example, we can use an intent to start the activity 
in Gmail that sends messages, and pass it the text we want to send. 
Instead of writing our own activities to send emails, we can use the 
existing Gmail app. 



You da* drea- te a* intent to start 
another activity even \( 
activity is within another app. 



This is 
the app 
you vc been 
working on 
'tbvou^bou't 
-tbe dbapiev 



Messenger 



Intent 




Intent 



IE) — pV 



W 

Android 




This means that you can build apps that perform far more powerful 
tasks by chaining together activities across the device. 
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Put we don't know what apps are on the device 



There are three questions we need answers to before we can call activities 
in other apps: 



o 

o 

o 



How do we know activities are available on the user’s device? 

How do we know which of these activities are appropriate for what we want to do? 
How do we know how to use these activities? 



The great news is that we can solve all of these problems using actions. 
Actions are a way of telling Android what standard operations activities 
can perfom. As an example, Android knows that all activities registered for 
a send action are capable of sending messages. 



What you’re going to do next is learn how to create intents that use 
actions to return a set of activities that you can use in a standard way — for 
example, to send messages. 



Here's what you're going to do 

Q Create an intent that specifies an action. 



The intent will tell Android you want to use an activity that can send a message. The intent 
will include the text of the message. 



o 



Allow the user to choose which app to use. 

The chances are there’ll be more than one on the device capable of sending messages, so 
the user will need to pick one. We want the user to be able to choose one every time they 
click on the Send Message button. 



• 




V a Q 14:29 W 


SEND MESSAGE 




A little messaaej 


- 


message's 


messages 


messaged 


1 2 3 


4 5 6 


7 8 9 0 


q w e r 


t y 


u i o p 


a s d 


f g h 


j k 1 


+ z X 


c v b 


n m <3 


?123 




9 


V 


o 


□ 



Send message... 

^ Messaging 
Q Hangouts 
M Gmail 
B Any.do 

£ g Add Recipe to MyFitnessPal 

^ Add to Dropbox 

4) 1 Android Beam 
@ Bluetooth 
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Q 



To 



A little message 

1 2 3 4 5 6 7 8 

q w e r t y u i o 
a s d f g h j k 
♦ zxcvbnm 

?1 23 



von 








Create an intent that specifies an action 



multiple activities and intents 

-►I | Specify action 

Create chooser 



So far you’ve seen how to create an intent that launches a specific activity using 



Intent intent = new Intent (this, ReceiveMessageActivity . class ) ; 



The intent is an explicit intent; you explicitly tell Android which class you 
want it to run. 

If there’s an action you want done but you don’t mind which activity does it, you 
create an implicit intent. You tell Android what sort of action you want it to 
perform, and you leave the details of which activity performs it to Android. 



Y 

We* ve *told 'the intent which 
dlass its intended (or, but 
what i*P we don*t know? 



How to create the intent 

You create an intent that specifies an action using the following syntax: 

Intent intent = new Intent (action) ; 

where action is the type of activity action you want to perform. Android 
provides you with a number of standard actions you can use. As an example, 
you can use Intent . ACTION_DIAL to dial a number, 

Intent . ACTION_WEB_SEARCH to perform a web search, and 
Intent . ACTION_SEND to send a message. So if you want to create an 
intent that specifies you want to send a message, you use 

Intent intent = new Intent (Intent . ACTION_SEND) ; 

Adding extra information 

Once you’ve specified the action you want to use, you can add extra 
information to it. We want to pass some text with the intent that will form the 
body of the message we’re sending. To do this, you use the following lines of 
code: 



You can line! out 
more about the 
sorts ol activity 
actions you can 
use and the extra 
information they 
support in the 
Android developer 
reference material: 
http: A / tinyuvl.com/ 



nSPcjhS. 



intent . setType ( " text/plain" ) ; 

intent . putExtra ( Intent . EXTRA_TEXT , messageText) ; ^ ^These attributes relate 

to MMCTIOVJZBMV- 

where messageText is the text you want to send. This tells Android that TheyVe not relevant -for 

you want the activity to be able to handle data with a MIME data-type of a || anions. 

“text/plain”, and also tells it what the text is. 



You can make extra calls to the putExtra () method if there’s additional 
information you want to add. As an example, if you want to specify the subject 
of the message, you can also use 

intent . putExtra ( Intent . EXTRA_SUB JECT , sub j ect ) ; 

where subject is the message subject. 



I( subject isn't relevant to a 
particular app, i-t will just ignore 
this in-formation- Any apps that 
know how to use it will do so. 
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Change the intent to use an action 

We’ll update CreateMessageActivity.java so that we create an implicit 
intent that uses a send action. Make the changes highlighted below, 
and save your work: 



-►I | Specify action 

Create chooser 



package com. hfad. messenger; 

import android. os . Bundle; 
import android . app . Activity; 
import android . content . Intent ; 
import android. view. View; 
import android. widget .EditText; 



□ 

Messenger 

4a 

app/src/main 

43 



java 






com. hfad. messenger 

LQ 



public class CreateMessageActivity extends Activity { 



CreateMessage 

Activity.java 



@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_create_message ) ; 



} 



//Call onSendMessage ( ) when the button is clicked 
public void onSendMessage (View view) { 

EditText messageView = (EditText) findViewByld (R. id. message) ; 

String messageText = messageView . getText (). toString () ; 

Remove ‘these Tri t C7i s fe-^~>T^ r n7T^eril^( ; 

■two lines. pi 1 1 r a p i s a S A C E 7 — mn^wqgoT^xt ) j 

Intent intent = new Intent (Intent . ACTION_SEND) ; 
intent . setType ( " text/plain" ) ; 

intent . putExtra ( Intent . EXTRA_TEXT , messageText) 

startActivity (intent) ; 




Instead Jr dveatinj an intent that's 
e*plititly tv- RedeiveMessa^eAdtWity, we've 
tveatinj an intent that uses a send adtion- 



Let’s break down what happens when the user clicks 
on the Send Message button. 
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What happens when the code runs 



O 



When the onSendMessoge() method 
is called, an intent gets created. 
The start ActivityO method passes 
the intent to Android. 

The intent specifies an action of 
ACTION_SEND, and a MIME type of 
text/ plain. 



onSendMessage ( ) 

o 

CreateMessageActivity 



Intent 

-E3 * 

ACTION_SEND 
type: "text/plain" 
messageTextf'Hi!" 



orjo 

VU 

Android 



© 



Android sees that the intent can only 
be passed to activities able to handle 
ACTION_SEND and text/plain data. 
Android checks all the activities, looking 
for ones that are able to receive the 
intent. 

If no actions are able to handle the intent, an 
ActivityNotFoundException is thrown. 



Aha, an implicit intent. I need 
to find all the activities that 
can handle ACTI0N_SEND / 
data of type text/plain, and 
have a category of DEFAULT. 




CreateMessageActivity 




Android 



© 



If just one activity is able to receive 
the intent. Android tells the activity 
to start and passes it the intent. 




Activity 
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what happens 



The story continues... 




Specify action 
Create chooser 



O 



If more than one 
activity is able to 
receive the intent, 
Android displays an 
activity chooser dialog 
and asks the user 
which one to use. 




0 



When the user 
chooses the activity 
she wants to use. 
Android tells the 
activity to start and 
passes it the intent. 
The activity displays the 
extra text contained in 
the intent in the body of 
a new message. 




Chosen 

Activity 



In order to create the activity chooser dialog, Android 
must know which activities are capable of receiving the 
intent. On the next couple of pages we’ll look at how it 
does this. 
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The intent filter tells Android which 
activities can handle which actions 

When Android is given an intent, it has to figure out which activity, 
or activities, are able to handle it. This process is known as intent 
resolution. 

When you use an explicit intent, intent resolution is straightforward. 

The intent explicitly says which component the intent is directed 
at, so Android has clear instructions about what to do. As an 
example, the following code explicitly tells Android to start 
ReceiveMessageActivity: 

Intent intent = new Intent (this, ReceiveMessageActivity . class) ; 
startActivity (intent ) ; 

When you use an implicit intent, Android uses the information in the 
intent to figure out which components are able to receive it. It does this 
by checking the intent filters in every app’s copy of AndroidManifest.xml. 

An intent filter specifies what types of intent each component can 
receive. As an example, here’s the entry for an activity that can handle 
an action of ACTION_SEND. The activity is able to accept data with 
MIME types of text/plain or image: 



<activity android : name="ShareActivity"> 

<intent-filter> 




This tells Andv-oid the 
activity can handle 

ACTIOM_SSHD- 



<action android : name= " android . intent . action . SEND " /> 
<category android: name=" android. intent . category .DEFAULT" /> 



The ‘m'tch't -fil'ter 
must mdlude 



These are the types 
o- P data the activity 

</intent-filter> ^ 

</ activity> 



<data android : mimeType=" text/plain" /> 
<data android : mimeType=" image/* " /> 



a datc^ory ©I 

DEFAULT or it 
wor/t be able to 
redeive implidit 
intents. 



The intent filter also specifies a category. The category supplies extra 
information about the activity such as whether it can be started by a web 
browser, or if it’s the main entry point of the app. An intent filter must 
include a category of android . intent . category . DEFAULT 
if it’s to receive implicit intents. If an activity has no intent filter, or it 
doesn’t include a category name of android . intent . category . 
DEFAULT, it means that the activity can’t be started with an implicit 
intent. It can only be started with an explicit intent using the fully 
qualified component name. 



you are here ► 



101 



intent filters 



How Android uses the intent filter 




Specify action 
Create chooser 



When you use an implicit intent, Android compares the information given 
in the intent with the information given in the intent filters specified in every 
app’s AndroidManifest.xml file. 

Android first considers intent filters that include a category of android . 
intent . category . DEFAULT: 

<intent- filter > 

<category android: name=" android . intent . category . DEFAULT "/> 



</ intent-f ilter> 



Intent filters without this category will be omitted as they can’t receive implicit 
intents. 



Android then matches intents to intent filters by comparing the action and 
MIME type contained in the intent with those of the intent filters. As an ^ 
example, if an intent specifies an action of Intent . ACTION_SEND using: 

Intent intent = new Intent ( Intent .ACTION_SEND); 



li will also look al -the datejory o-P 
•the iivteivt -Pil-tev- i-P one is supplied 
by -the intent This isnt used very 
orien, so weVe not Covering how to 
add datejovies to intents. 



Android will only consider activities that specify an intent filter with an action 
of android . intent . action . SEND like this: 



<intent-f ilter> 

<action android: name="android . intent . action . SEND"/> 



</ intent-f ilter> 

Similarly, if the intent MIME type is set to “text/plain” using 
intent . setType ( "text /plain" ) ; 

Android will only consider activities that can accommodate this type of data: 
<intent-f ilter> 

<data android :mimeType= "text /plain "/> 



</ intent-f ilter> 

If the MIME type is left out of the intent, Android tries to infer the type 
based on the data the intent contains. 

Once Android has finished comparing the intent to the component intent 
filters, it sees how many matches it finds. If Android finds a single match, 
Android starts the component (in our case, the activity) and passes it the 
intent. If it finds multiple matches, it asks the user to pick one. 
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BE ff*e Infer if 

Your job is to play like you’re 
the intent on the right and say 
which of the activities described 
below are compatible 
with your action and 
data. Say why or why 
not, for each one. 




Heve’s the in-tent- 



Intent intent = new Intent ( Intent . ACTION_SEND) ; 



intent . setType ( "text /plain" ) ; 



intent . putExtra ( Intent . EXTRA_TEXT, "Hello") ; 



<activity android : name="SendActivity"> 

<intent-f liter > 

<action android: name="android. intent . action . SEND"/> 
<category android : name="android . intent . category. DEFAULT" /> 
<data android : mimeType=" * /*" /> 

</ intent-f ilter> 

</ activity> 



<activity android : name="SendActivity"> 

< intent-f ilter> 

<action android : name=" android . intent . action . SEND" /> 
<category android : name="android . intent . category .MAIN"/> 
<data android : mimeType=" text /plain " /> 

</ intent-f ilter> 

</ activity> 



<activity android : name="SendActivity"> 

< intent- fil ter > 

<action android: name="android . intent . action . SENDTO"/> 
<category android : name="android . intent . category .MAIN"/> 
<category android : name="android . intent . category . DEFAULT" / > 
<data android : mimeType=" text /plain " /> 

</ intent-f ilter> 

</ activity> 
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solution 



BE tb& Infenf §©]ug©ti 

Your job is to play like you’re the 




intent on the right and say which 
of the activities described below 
are compatible with 
your action and 
data. Say why or 
why not, for each 
one. 



<activity android : name="SendActivity"> 

< intent- f ilter> 

<action android: name="android . intent . action . SEND"/> 
<category android : name="android . intent . category . DEFAULT" / > 
<data android :mimeType="*/*"/> 

</ intent-f ilter> 

</ activity> 



Intent intent = new Intent ( Intent . ACTION_SEND) ; 
intent . setType ( "text/plain" ) ; 

intent . putExtra ( Intent . EXTRA_TEXT, "Hello") ; 



This atlivrty addep-ts ACT|0N_SBND and 
/ da* handle data of any MIME type so it ean 
vespond to the intent- 



This activity doesn't have a eategovy 
DBF /\ULT so ean't vedeive the intent- 

<action android : name=" android . intent . action . SEND" /> 

<category android : name="android . intent . category .MAIN"/> 

<data android : mimeType=" text /plain " /> 

</ intent-f ilter> 

</ activity> 



<activity android : name="SendActivity"> 
< intent-f ilter> 



X 



This d£*tivi*ty SLCtY t A CT 1 0 N__S£-NP ’m*ten*ts, only 

ACT|0N_S£NPT0. ACT|0N_S£NPT0 allows you -to send 

a message to someone s^ed-i-fied in *thc in-ten-ts data. 

<action android: name="android . intent . action . SENDTO"/> 

<category android : name="android . intent . category .MAIN"/> 

<category android : name="android . intent . category . DEFAULT" / > 

<data android : mimeType=" text /plain " /> 

</ intent-f ilter> 

</ activity> 



<activity android : name="SendActivity"> 
< intent- fil ter > 



X 
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You need to run your app on a REAL device 

So far we’ve been running our apps using the emulator. The emulator 
only includes a small number of apps, and there may well be just one app 
that can handle ACTION_SEND. In order to test our app properly, we 
need to run it on a physical device where we know there’ll be more than 
one app that can support our action — for example, an app that can send 
emails and an app that can send messages. 

Here’s how you go about getting your app to run on a physical device. 

1. Enable USP debugging on your device 

On your device, open “Developer options” (in Android 
4.0 onward, this is hidden by default). To enable it, go to 
Ye?' Settings — > About Phone and tap the build number seven 

seriously — ^ times. When you return to the previous screen, you should 
be able to see “Developer options.” 

Within “Developer options,” tick the box to enable USB 
debugging / 

You need io enable USB debusing. 



1 . Set up your system to detect your device 

If you’re using a Mac, you can skip this step. 

If you’re using Windows, you need to install a USB driver. You can 
find the latest instructions here: 

http:/ / developer, android, com/ tools/ extras/ oem-usb. html 

If you’re using Ubuntu Linux, you need to create a udev rules file. 
You can find the latest instructions on how to do this here: 



V 



Specify action 
Create chooser 



* 


Q 14:35 I 


<- Developer options 


CL 


On 


<• 


1 


Debugging ■" 




USB debugging 

s^Debug mode when USB is connected 




Revoke USB debugging authorisations 




Bug report shortcut 

Show a button in the power menu for taking a 
bug report 


□ 


Allow mock locations 

Allow mock locations 


□ 


Enable view attribute inspection 


□ 


Select debug app 




< o □ 



http:/ / developer, android, com/ tools/ device. html#setting-up 



3 . Plug your device Into your computer with a U$& cable 

Your device may ask you if you want to accept an RSA key that allows USB ^ ^ ,s r * cssa 5 c 

debugging with your computer. If it does, you can tick the “Always allow from " 7°^ ,S 

this computer” option and choose OK to enable this. /Wv-oid T- • oV " *5 
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running on real devices 



Running your app on a real device (continued) 




Specify action 
Create chooser 



4. Run your app in Android Studio as normal 

Android Studio will install the app on your device and launch it. You may be 
asked to choose which device you want to run your app on. If so, select your 
device from the list available and click OK. 



eoo 



Choose Device 



The Jiwt 

device listed is 
ou\r emulator. - — ^ 

Here's our 
physical device 



{*) Choose a running device 



.A 



Device 


Serial Number 


State 


Compa... 


HI Emulator Nexus 4 API 21 Android 5.0 CAPI 21) 


emulator-5554 


Online 


Yes 


|D|lGE Nexus 4 Android 5.0 (API 21) 


0093f3aGd58a6a8e 


Online 


Yes 




Launch emulator 


Android virtual device: Nexus 4 API 21 






i) □ 


Use same device for future launches 












Cancel 


OK 1 




— 


\ 


r 



And here's the app running 
on the physical device 

You should find that your app looks about the same 
as when you ran it through the emulator. You’ll 
probably also find that your app installs and runs 
quicker too. 

Now that you know how to run the apps you create 
on your own device, you’re all set to test the latest 
changes to your app. 
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Test drive the app 



Try running the app using the emulator, and then using your own 
device. The results you get will depend on how many activities you have 
on each that support using the Send action with text data. 



If you have one activity 

Clicking on the Send Message button will take 
you straight to that app. 



tVe only have one activity available 
on the emulator that tan send ^ 
messages with text data* so when we 
ditk on the Send Message button, 
Android starts the activity 



If you have wore than one activity 

Android displays a chooser and asks you to pick which one you want 
to use. It also asks you whether you want to use this action just once 
or always. If you choose always, the next time you click on the Send 
Message button it uses the same activity by default. 




SEND MESSAGE 



A little messaa 






message's messages messaged 

1 2 3 4 5 6 7 8 

q w e r t y u i o 
a s d f g h j k 

^ zxcvbnm 



von 



Share with Messaging 



rv 



We have lots ot suitable activities available 
on omr physical device Wb decided -to use 
ihe Messaging app. We selected the "always" 
option— gveat it we always want to use 
Messaging, not so gveat it we want to use 
a dittevent one each time- 
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% : 


Use a different app 




To 



0 Hangouts 
M Gmail 
Any. do 

Add Recipe to MyFitnessPal 
Add to Dropbox 
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let the user choose 



What if you ALWAYS want your users to choose an activity? 



You’ve just seen that if there’s more than one activity on 
your device that’s capable of receiving your intent, Android 
automatically asks you to choose which activity you want to use. It 
even asks you whether you want to use this activity all the time or 
just on this occasion. 

There’s just one problem with this default behavior: what if you 
want to guarantee that users can choose an activity every time they 
click on the Send Message button? If they’ve chosen the option to 
always use Gmail, for instance, they won’t be asked if they want to 
use Twitter next time. 

Fortunately, there’s a way around this. You can create a chooser 
that asks you to pick an activity without asking if you always want 
to use it. 

Iwtent.createChooserO displays a chooser dialog 

You can achieve this using the Intent . createChooser ( ) 
method. This method takes the intent you’ve already created, 
and wraps it in a chooser dialog. The big difference in using this 
method is that you’re not given the option of choosing a default 
activity — you get asked to choose one every time. 



createChooserO allows 
you to specify a title lor 
the chooser dialog, and 
doesn’t give the user 
the option ol selecting 
an activity to use hy 
default. It also lets the 
user know if there are 
no matching activities 
hy displaying a message. 



You call the createChooser ( ) method like this: 






This is *thc intent you dredted eavjiev. 



') 



Intent chosenlntent = Intent . createChooser (intent , "Send message. 

The method takes two parameters: an intent and an optional ./ . , , , r . , 

■ +V1 r m u mi • a mu t A ^ Y ou * title For the 

String title lor the chooser dialog window. I he Intent . iu 4- ± a- l 11 

parameter needs to describe the types of activity you want the ± p . , ^ ^ ,S ^ 3 

chooser to display. You can use tJsame intern 2 created earlier, ^ tkt 

as this specifies that we want to use ACTION_SEND with textual 
data. 



The createChooser ( ) method returns a brand-new Intent. 
This is a new explicit intent that’s targeted at the activity chosen by 
the user. It includes any extra information supplied by the original 
intent, including any text. 

To start the activity the user chose, you need to call 



startActivity (chosenlntent) ; 



We’ll take a closer look over the next couple of pages at what 
happens when you call the createChooser () method. 
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What happens when you call createChooserl) 

This is what happens when you run the following two lines of code: 

Intent chosenlntent = Intent . createChooser (intent, "Send message..."); 
startActivity (chosenlntent) ; 



y| Specify action 
Create chooser 



o 



The createChooser() method 
gets called. 

The method includes an intent that 
specifies the action and MIME type 
that’s required. 



createChooser ( ) 
Intent 




CreateMessageActivity message 



ACTION_SEND 
type: "text/plain" 
messaae: ,, Hir 



^orjo 

\nj 

Android 



o 



Android checks which activities 
are able to receive the intent 
by looking at their intent 
filters. 

It matches on the actions, type of data, 
and categories they can support. 




© 



If more than one activity is 
able to receive the intent. 
Android displays an activity 
chooser dialog and asks the 
user which one to use. 

This time it doesn’t give the user the 
option of always using a particular 
activity and it displays “Send 
message...” in the title. 

If no activities are found, Android 
still displays the chooser but shows a 
message to the user telling her there 
are no apps that can perform the 
action. 




User 
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what happens 



The story continues... 



V 



Specify action 
Create chooser 



O 



When the user chooses 
which activity she wants to 
use. Android returns a new 
explicit intent describing 
the chosen activity. 

The new intent includes any 
extra information that was 
included in the original intent, 
such as any extra text. 




O' 



CreateMessageActivity 



Intent 



ChosenActivity 

message:"Hi!" 



orfj 

\nj 

Android 




User 



The activity asks 
Android to start the 
activity specified in 
the intent. 




CreateMessageActivity 



To: ChosenActivity 
message:"Hi!" 



\nj 

Android 



@ Android asks the 

activity specified by 
the intent to start, 
and then passes it the 
intent. 



CreateMessageActivity 
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Change the code to create a chooser 



We’ll change the code so that the user gets asked which activity they want to use 
to send a message every time they click on the Send Message button. We’ll update 
the onSendMessage ( ) method in CreateMessageActivity.java so that it calls the 
create Chooser () method, and we’ll add a string resource to strings, xml for the 
chooser dialog title. 



Update $tring$.xml... 

We want the chooser dialog to have a title of “Send message...”. Add 
a string called “chooser” to strings. xml, and give it the value “Send 
message...” (make sure to save your changes): 



□ 

Messenger 

4a 

app/src/main 

4T3 



<string name= " chooser " >Send message. . .</string> 



...and update the owSewdMessageO method 




values 




strings.xml 



We need to change the onSendMessage ( ) method so that it 
retrieves the value of the chooser string resource in strings.xml , calls 
the create Chooser () method, and then starts the activity the 
user chooses. Update your code as follows: 



□ 

Messenger 

K3 



app/src/main 

41 



//Call onSendMessage ( ) when the button is clicked 
public void onSendMessage (View view) { 

EditText messageView = (EditText) findViewByld (R. id. message) ; 
String messageText = messageView . getText (). toString () ; 

Intent intent = new Intent (Intent . ACTI0N_SEND) ; 
intent . setType ( "text/plain" ) ; 

intent . putExtra ( Intent . EXTRA_TEXT, messageText) ; 

String chooserTitle = getString (R. string, chooser) ; 

Intent chosenlntent = Intent . createChooser (intent , chooserTitle); 



java 



4U 



com, hfad. messenger 



£jet *the 
dhooser title. 



CreateMessage 

Activity.java 



s tar tActivity (chosenlntent) ; ^ — - Start the activity 
} that the user seledted. 



V- 

Display the dhooser dialog. 



The getString () method is used to get the value of a string resource. It takes 
one parameter, the ID of the resource (in our case, this is R. string . chooser): 

getString (R. string, chooser) ; ^ Y ou J 00 ^ m y° u II “find dhooser 

in the inner dlass dalled string. 

Now that we’ve updated the app, let’s run the app to see our chooser in action. 
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test drive 

Test drive the app 

Save your changes, then try running the app again 

If you have one activity 

Clicking on the Send Message button will take 
you straight to that app just like before. 

There's no change here— 

/Wroid towtinues -to -take 
you straight -to ihe activity. 



V 



Specify action 
Create chooser 
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( New message ■ 



If you have wore thaw owe activity 



A little message| 






(To 



A little message 



Android displays a chooser but this time it doesn’t ask us if we always 
want to use the same activity It also displays the value of the chooser 
string resource in the title. 




Here's -the chooser we treated with 
createChooserO. It no lonjer ^ves us the option 
ot usinj a particular activity every time. 



SEND MESSAGE 



A little messaae| 



message’s messages messaged 
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q w e r t y u i o 
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If you have NO matching activities 



If you have no activities on your device that are capable of sending 
messages, the createChooser ( ) method lets you know by 
displaying a message. 

This behavior is another benefit to using the createChooser () 
method. The createChooser ( ) method is able to deal with 
situations where no activities can perform a particular action. 

l-f you wairt -to replicate -this -for yourself, 7 
■try running the app m the emulator, and 
disable the Messaging app that's on there- 



Send Message 



Send message. 



No apps can perform this 
action. 



So I can run my apps in the 
emulator or on a physical device. Which 
is best? 

Each one has its pros and cons. 

If you run apps on your physical device, 
they tend to load a lot quicker than using 
the emulator. It’s also useful if you’re 
writing code that interacts with the device 
hardware. 

The emulator allows you to run apps 
against many different versions of 
Android, screen resolutions, and device 
specifications. It saves you from buying lots 
of different devices. 

The key thing is that you make sure you 
test your apps thoroughly using a mixture 
of the emulator and physical devices before 
releasing them to a wider audience. 



tJiereiiire no 

Dumb Questions 



Should I use implicit or explicit 
intents? 



It comes down to whether you need 
Android to use a specific activity to perform 
your action, or whether you just want the 
action done. As an example, suppose you 
wanted to send an email. If you don’t mind 
which email app the user uses to send it, 
just as long as the email gets sent, you’d 
use an implicit intent. On the other hand, if 
you needed to pass an intent to a particular 
activity in your app, you’d need to use an 
explicit intent. You need to explicity say 
which activity needs to receive the intent. 



You mentioned that an activity’s 
intent filter can specify a category as 
well as an action. What’s the difference 
between the two? 



An action specifies what an activity 
can do, and the category gives extra 
detail. We’ve not gone into details about 
the category because you don’t often need 
to specify a category when you create an 
intent. 

O: You say that the 
createChooser () method 
displays a message in the chooser 
if there are no activities that can 
handle the intent. What if I’d just 
used the default Android chooser 
and passed an implicit intent to 
startActivity ( ) ? 

If the startActivity ( ) 

method is given an intent where 
there are no matching activities, an 
ActivityNotFoundException 
is thrown. If you don’t catch this using a 
try/catch block, it may cause your 
app to crash. 
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toolbox 




and intents to your toolbox. 



You’ve got Chapter 3 under 
your belt and now you’ve 
added multiple activity apps 



Your Android Toolbox 



Yow ta* download 
-Pull tode &>v 
i\\t Rafter Prom 



HcadiF‘»rstA^clroid. 




BULLET POINTS 



■ A task is two or more activities chained together. 

■ The <Edi tText > element defines an editable text field for entering text. It inherits from the Android view class. 

■ You can add a new activity in Android Studio by choosing File —> New... — > Activity. 

■ Each activity you create must have an entry in AndroidManifest.xml. 

■ An intent is a type of message that Android components use to communicate with one another. 

■ An explicit intent explicitly specifies the component the intent is targeted at. You create an explicit intent using 

Intent intent = new Intent (this. Target . class ) ; 

■ To start an activity, call s tar tActivity (intent) . If no activities are found, it throws an 

ActivityNotFoundException. 

■ Use the putExtra ( ) method to add extra information to an intent. 

■ Use the getintent ( ) method to retrieve the intent that started the activity. 

■ Use the get*Extra ( ) methods to retrieve extra information associated with the intent. 
getStringExtra ( ) retrieves a String, getintExtra ( ) retrieves an int, and so on. 

■ An activity action describes a standard operational action an activity can perform. To send a message, use 

Intent . ACTION_SEND. 

■ To create an implicit intent that specifies an action, use 

Intent intent = new Intent (action) ; 

■ To describe the type of data in the intent, use the setType ( ) method. 

■ Android resolves intents based on the named component, action, type of data, and categories specified in the 

intent. It compares the contents of the intent with the intent filters in each app’s AndroidManifest.xml. An activity 

must have a category of default if it is to receive an implicit intent. 

■ The createChooser ( ) method allows you to override the default Android activity chooser dialog. It allows you 
to specify a title for the dialog, and doesn’t give the user the option of setting a default activity. If no activities can 
receive the intent it is passed, it displays a message. The createChooser ( ) method returns an intent. 

■ You retrieve the value of a string resource using getstring (R. string, stringname) ; 
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4 the actiVity lifecycle 



^ Being an Activity + 




Activities form the foundation of every Android app. 

So far you’ve seen how to create activities, and made one activity start another using an 
intent. But what’s really going on beneath the hood? In this chapter, we’re going to dig 
a little deeper into the activity lifecycle. What happens when an activity is created and 
destroyed? Which methods get called when an activity is made visible and appears in 
the foreground, and which get called when the activity loses the focus and is hidden? 
And how do you save and restore your activity’s state? 



this is a new chapter 
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How do activities really work? 



So far you’ve seen how to create apps that interact with the user, 
and apps that use multiple activities to perform tasks. Now that you 
have these core skills under your belt, it’s time to take a deeper look 
at how activities actually work. Here’s a recap of what you know so 
far, with a few extra details thrown in. 



o 



An app is a collection of activities, layouts, and other resources. 

One of these activities is the main activity for the app. 



fcacM app l^as a ma'm activity, 
as specified *m file 

Andv-oidMani-f est %ml . 


-o 

Main Activity 


App 

O 

Activity 




o 

Activity 


Activity 



O 



By default, each app runs within its own process. 

This helps keep your apps safe and secure. You can read more about this in Appendix i 
(which covers the Android runtime, or ART) at the back of this book. 



Process 1 



^pp 1 

O o 

Activity 

o o 

Activity 

Activity 



Process 2 
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o 



You can start an activity in another application by passing an intent 
with start Activity(). 

The Android system knows about all the installed apps and their activities, and uses the 
intent to start the correct activity. 




o 



When an activity needs to start. Android checks if there's already a 
process for that app. 

If one exists, Android runs the activity in that process. If one doesn’t exist, Android 
creates one. 




When Android starts an activity, it calls its onCreate() method. 

onCreate() is always run whenever an activity gets created. 




Android 



onCreateQ 




Activity 



But there are still lots of things we don’t yet know about how activities 
function. How long does the activity live for? What happens when 
your activity disappears from the screen? Is it still running? Is it still 
in memory? And what happens if your app gets interrupted by an 
incoming phone call? We want to be able to control the behavior of 
our activities in a whole range of dfferent circumstances , but how? 



*PP2 



O 

Activity 



you are here ► 



117 



stopwatch 



The Stopwatch app 

In this chapter, we’re going to take a closer look at how activities 
work under the hood, common ways in which your apps can 
break, and how you can fix them using the activity lifecycle 
methods. We’re going to explore the lifecycle methods using a 
simple Stopwatch app as an example. 

The Stopwatch app consists of a single activity and a single 
layout. The layout includes a text view showing you how much 
time has passed, a Start button that starts the stopwatch, a Stop 
button that stops it, and a Reset button that resets the timer 
value to zero. 



U 09:05 



0:00:09 



START 



STOP 



<T 



RESET 



_^^This is -the number 
o*f seconds. 



When you eliek on ■the 
Start button, the seconds 
begin to increment- 

1/Vhen you dick on the 
Stop button, the seconds 
stop incrementing. 

' When you eliek on the 
Reset button, the 
seconds goes back to O. 



Puild the app 

You have enough experience under your belt to build the app 
without much guidance from us. We’re going to give you just 
enough code to be able to build the app yourself, and then you 
can see what happens when you try to run it. 

Start off by creating a new Android project for an application 
named “Stopwatch” with a package name of com . hf ad . 
stopwatch. The minimum SDK should be API 15 so 
it can run on most devices. You’ll need an activity called 
“StopwatchActivity” and a layout called “ activity_stop watch”. 




StopwatchActivity.java 
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The stopwatch layout code 

Here’s the XML for the layout. It describes a single text view that’s used to 
display the timer, and three buttons to control the stopwatch. Replace the 
XML currently in activity _stopwatch. xml with the XML shown here: 



<RelativeLayout xmlns : android="http : / / schemas . android . com/ apk/ res/ android" 
xmlns : tools="http : / / schemas . android. com/ tools" 



android : layout_width="match_parent " 

android : layout_height="match_parent" 

android : paddingBottom=" 1 6dp" 

android : paddingLef t=" 1 6dp" 

android : paddingRight=" 1 6dp" 

android : paddingTop=" 1 6dp" 

tools : context=" . StopwatchActivity" > 



□ 

Stopwatch 

HB 

app/src/main 

HS 

res 

ms 

layout 



<TextView 

android : 
android : 
android : 
android: 
android : 
android : 
android : 
android : 
android : 

<Button 

android : 
android : 
android : 
android : 
android : 
android : 
android : 
android : 



We II use this text view to 
display the number o£ seconds. 



id=" @+id/ time_view 
layou t_width= " wrap_con ten t " 
layout_height="wrap_content" 
layout_alignParentTop="true" 
layout_centerHorizontal=" true" 
layout_marginTop=" Odp" 
text=" " 

textAppearance=" ?android : attr/ textAppearanceLarge 
textSize=" 92sp" /> 



1 

hese attributes make the 
stopwatch timer nite and big. 



id="@+id/start_button" 
layout_width="wrap_content" 
layou t_height="wrap_con tent" 
layout_below=" @+id/time_view" 
layou t_cen terHor i zon tal= " true " 
layou t_marginTop= " 2 Odp " 
onClick="onClickStart" 
text="@string/start" /> 



-This is -for the Start 
button- It tails a method 
tailed onClitkStartO 
when it gets tlitked- 



activity_ 
stopwatch. xml 



The layout 

tode tontinues 
over the page. 
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The layout code (continued) 

<Button 

android: id= M @+id/ stop_but ton" 
android : lay out_width="wrap_con tent" 



□ 

Stopwatch 

ma 

app/src/main 

H3 



android : layout_height="wrap_content " 

android : layout below="@+id/start button" A 

This is tor -the s-toy 

android: layout_centerHorizontal=" true" ^ ^|| s ^ 

android : layout_marginTop=" lOdp" method tailed 

android: onClick="onClickStop" ^ onClitk£*topO when 

android: text="@ string/ stop" /> it jets disked- 




activity, 
stopwatch. xml 



This is (ox the Reset button. 
It tails ohClitkR 
t jets dieted. 



<Button 

android: id="0+id/reset_button" ^ da ^ s onClidcResetO when 
android : lay out_width="wrap_con tent 
android : layout_height="wrap_content " 
android : layout_below=" @+id/stop_button 
android : layou t_cen terHor i zon tal= " true " 
android : layou t_marginTop=" lOdp" 
android : onClick="onClickReset" 
android: text="@ string/reset" /> 




r 



T 

Da 



</RelativeLayout> 



Make sure you update 
the layout and strings, 
xml in your app before 
continuing. 



The stopwatch strings.xwl file 



The layout uses three extra String values, one for the text value of each 
button. These values are String resources, so need to be added to strings, 
xml. Add the string values below to strings. xml: 



□ 

Stopwatch 

t3 



<s tr ing name= " s tart " >S tar t</ s tr ing> 



<string name="stop">Stop</string> These ave “the 

<string name=" reset ">Reset</string> 



— I nCiC dTC wrc 

button labels. 



app/src/main 

Lfia 



res 



W 



The layout is done! Next, let’s move on to the activity. 



values 




strings.xml 
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How the activity code will work 

The layout defines three buttons that we’ll use to control 
the stopwatch. Each button uses its onClick attribute 
to specify which method in the activity should run when 
the button is clicked. When the Start button is clicked, the 
onClickStart ( ) method gets called, when the Stop 
button is clicked the onClickStop ( ) method gets called, 
and when the Reset button is clicked the onClickReset ( ) 
method gets called. We’ll use these method to start, stop, and 
reset the stopwatch. 




We’ll update the stopwatch using a method we’ll create called 
run Timer ( ) . The run Timer ( ) method will run code 
every second to check whether the stopwatch is running, 
increment the number of seconds and display the number of 
seconds in the text view. 

To help us with this, we’ll use two private variables to record 
the state of the stopwatch. We’ll use an int called seconds 
to track how many seconds have passed since the stopwatch 
started running, and a boolean called running to record 
whether the stopwatch is currently running. 

We’ll start by writing the code for the buttons, and then we’ll 
look at the run Timer ( ) method. 



runTimerQ 




Activity 
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Add code for the buttons 

When the user clicks on the Start button, we’ll set the running variable 
to true so that the stopwatch will start. When the user clicks on the 
Stop button, we’ll set running to false so that the stopwatch stops 
running. If the user clicks on the Reset button, we’ll set running 
to false and seconds to 0 so that the stopwatch is reset and stops 
running. 

Replace the contents of StopwatchActivity.java with the code below: 



package com . hf ad . stopwatch ; 




import android . os . Bundle ; 
import android . app . Activity ; 
import android. view. View; 

public class StopwatchActivity extends Activity { 



□ 

Stopwatch 

HU 

app/src/main 

^3 



private int seconds = 0 ; 
private boolean running; 4 ^^ 



Use seconds and running to redord 
the number o-P seconds passed and 
whether the stopwatch is running. 



java 






com . hfad. stopwatch 



@ Override 

protected void onCreate (Bundle savedlnstanceState) 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activi ty_s topwatch) ; 



Stopwatch 

Activity.java 



} 



//Start the stopwatch running when the Start button is clicked, 
public void onClickStart (View view) { < This aets tailed when the 

^ running - true ; Stavt tbe stopwatdb running Start button is tlitked- 



//Stop the stopwatch running when the Stop button is clicked, 
public void onClickStop (View view) { This gets ealled when the 

running. 



running - f .In. ^ 



stop button is disked- 



//Reset the stopwatch when the Reset button is clicked, 
public void onClickReset (View view) { ^ ^ called 

seconds = sto ? wateb Reset 

} running and set tbe button is dlidked- 

setonds to 0 . 
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The runTimer!) method 



The next thing we need to do is create the runTimer ( ) method. 
The runTimer ( ) method will get a reference to the text view in 
the layout, format the contents of the seconds variable into hours, 
minutes, and seconds, and then display the results in the text view. If 
the running variable is set to true, it will increment the seconds 
variable. Here’s the code: 



private void runTimer ( ) { 

final TextView timeView = 




6\t{. “the view. 



(TextView) findViewByld (R. id. time_view) ; 



We've le-fi 
oui a bii o( 
£ode here. 
Well look at 
that OY\ the 
ne*t page- 



int hours = seconds/3600; 
int minutes = (seconds%3600) /60 ; 
int secs = seconds%60; 

String time = String. format ("%d: %02d: %02d" , 
hours, minutes, secs) ; 
timeView. setText ( time) ; , 
if (running) { 



Set the text view text- 



Format the seconds into hours, 
minutes, and seconds. This is 
plain Java eode. 



} 



seconds++ ; running is true, increment 

the seconds variable- 



} 



We need this code to keep looping so that it increments the seconds 
variable and updates the text view every second. We need to do this in 
such a way that we don’t block the main Android thread. 

In non- Android Java programs, you can perform tasks like this using a 
background thread. In Androidville, this is a problem — only the main 
Android thread can update the user interface, and if any other thread 
tries to do so, you get a CalledFromWrongThreadException. 

The solution is to use a Handler. We’ll look at this on the next page. 



you are here ► 



123 



handlers 



Handlers allow you to schedule code 

AHandlerisan Android class you can use to schedule code that 
should be run at some point in the future. You can also use it to post 
code that needs to run on a different thread. In our case, we’re going 
to use aHandlerto schedule the stopwatch code to run every second. 

To use the Handler, you wrap the code you wish to schedule in 
a Runnable object, and then use the Handler post ( ) and 
postDelayed() methods to specify when you want the code to run. 

Let’s take a closer look at these mehods. 

The postO method 

The post () method posts code that needs to be run as soon as 
possible (which is usually almost immediately). The post ( ) method 
takes one parameter, an object of type Runnable. A Runnable 
object in Androidville is just like a Runnable in plain old Java, 
a job you want to run. You put the code you want to run in the 
Runnable’s run ( ) method, and the Handler will make sure the 
code is run as soon as possible. Here’s what the method looks like: 

final Handler handler = new Handler (); 

handler .post (Runnable) — \y/ ou p u *k -(^e Code you want to run in tbe tta^dlcv s runO method- 



The postPelayedO method 

The postDelayed() method works in a similar way to the post ( ) 
method except that you use it post code that should be run in the 
future. The postDelayed() method takes two parameters: a 
Runnable and a long. The Runnable contains the code you want 
to run in its run ( ) method, and the long specifies the number of 
milliseconds you wish to delay the code by. The code will run as soon 
as possible after the delay. Here’s what the method looks like: 

final Handler handler = new Handler (); 

handler. postDelayed (Runnable, long) ; Use this method to delay running Lode 

by a speCi-Pied number o\ milliseconds. 

On the next page, we’ll use these methods to update the stopwatch 
every second. 



1 24 Chapter 4 



the activity lifecycle 



The full runTimer!) code 



To update the stopwatch, we’re going to repeatedly schedule code using 
the Handler with a delay of 1,000 milliseconds each time. Each time the 
code runs, we’ll increment the seconds variable and update the text view. 

Here’s the full code for the runTimer ( ) method: 



private void runTimer () { 

final TextView timeView = (TextView) findViewByld (R. id. time_view) ; 

final Handler handler = new Handler () ; ^ — Orta td 3 new Handler. 



Runnable ( ) ( .^Call ^ ^ ^ Ue 

0 Override meihod pvodesses codes without a delay, so the Code in the 

public void run () { Runnable will vun almost immediately. 

int hours = seconds/3600; 

int minutes = (seconds%3600) /60; . 

The Runnable vunU method 

int secs = seconds%60; , . ^ , i i 

dontams the Code you want to 



String time = String . format ( "%d: %02d : %02d" , ^ be vwn-in ouv Case! the Code 
hours, minutes, secs); to update the te*t view. 

timeView . setText (time) ; 
if (running) { 
seconds++; 



} 



}>; 



} 

handler . pos tDelayed ( this , 1000) ; ><^Posi -the Code in -the Runnable -to be run again 

a-P-tev a delay of 1,000 millisedonds, or / seto^d- 
As -this line of Code is indluded in "the Runnable 
vunO method, this will keep getting dalled- 



Using the post ( ) and postDelayed ( ) methods in this way means 
that the code will run as soon as possible after the required delay, which 
in practice means almost immediately. While this means the code will lag 
slightly over time, it’s accurate enough for the purposes of exploring the 
lifecycle methods in this chapter. 

We want the runTimer ( ) method to start running when 
StopwatchActivity gets created, so we’ll call it in the activity 
onCreate ( ) method: 

protected void onCreate (Bundle savedlnstanceState) { 



runTimer ( ) ; 

} 



We’ll show you the full code for the activity on the next page. 
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The full StopwatchActivity code 

Here’s the full code for StopwatchActivity.java. Update your code with our 
changes below. 



package com. hfad. stopwatch; 

import android . os . Bundle; 
import android . os . Handler ; 
import android . app .Activity; 
import android . view .View; 
import android . widget . TextView; 

public class StopwatchActivity extends Activity { 
//Number of seconds displayed on the stopwatch. 



□ 

Stopwatch 

43 

app/src/main 

43 



java_ 

L3 

com. hfad. stopwatch 



Stopwatch 

Activity.java 



private int seconds = 0; 



//Is the stopwatch running? 



private boolean running; 




Use seconds and running to record 
-the number o( seconds passed and 
whether the stopwatch is running 



@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_stopwatch) ; 

runTimer ( ) ; ^ 



- Were using a separate method to 
updaie ■the stopy/ateh. WeVe starting it 
when -the ad-tivi-ty is treated. 



//Start the stopwatch running when the Start button is clicked, 
public void onClickStart (View view) { < ^ This $els tailed *hen the 

running = true; ^ ^rt ^ sfcfl?w#UK Start button is tlitked- 



//Stop the stopwatch running when the Stop button is clicked, 
public void onClickStop (View view) { ^ This gets called when "the 

running = false; . . 

v^^top the stopwatch running. 



Stop button is disked- 
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The activity code (continued) 



//Reset the stopwatch when the Reset button is clicked, 
public void onClickReset (View view) { 

running = false; . , , . 

the stop'watch 



seconds = 0 






running dnd set the 
seconds to O- 



" Ti^is c^ets 
tailed when 
-the Reset 

button is 
tlitked- 



□ 

Stopwatch 



4U 

app/sre/main 

Lfia 



java 



£jet the te%t vi ew. 



//Sets the number of seconds on the timer, 
private void runTimer ( ) { 

final TextView timeView = (TextView) findViewByld (R. id. time_view) 
final Handler handler = new Handler (); 

handler . post (new Runnable ( ) { (x se a Handler {o ? ost Code- 

@ Override 

public void run() { 

int hours = seconds/3600; 
int minutes = (seconds%3600) /60 
int secs = seconds%60; 

String time = String . format ( "%d: %02d: %02d M , 
hours, minutes, secs) ; 



ms 



com . hfad . stopwatch 

L @ 

Stopwatch 

Activity.java 






Format the seconds into 
hours, minutes, and seconds. 



timeView . setText (time) ; ^ ^ ^ ^ Vicw ^ 
if (running) { 

seconds++ ; \( running is true, increment 

} the seconds variable- 

handler . pos tDelayed ( this , 1000) ; 4^ post the dode again with a delay o-f I second- 



} 



} 



}) ; 



Let’s look at what happens when the code runs. 




Make sure you update 
your activity code with 
our changes. 
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What happens when you run the app 



O 



The user decides she wants to run the app. 

She clicks on the icon for the app on her device. 




© The AndroidManif est . xml file for the app specifies which activity 
to use as the launch activity. 

An intent is constructed to start this activity using startActivity (intent) . 




AndroidManifest.xml Android 



© 



Android checks if there's already a process running for the app, 
and if not, creates a new process. 

It then creates a new activity object — in this case, for StopwatchActivity. 



Process 1 
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The story continues 



O 



The onCreate() method in the activity gets called. 

The method includes a call to set Con tent View ( ) , specifying a layout, and then 
starts the stopwatch with run Timer ( ) . 



Q 



runTimer() 

StopwatchActivity Layout 

When the onCreate() method finishes, the layout gets displayed on the 
device. 




The runTimer ( ) method uses the seconds variable to determine what text to display 
in the text view, and uses the running variable to determine whether to increment 
the number of seconds. As running is initially false, the number of seconds isn’t 




% Why does Android run an app inside a separate 
process? 

For security and stability. It prevents one app accessing the 
data of another. It also means if one app crashes, it won’t take 
others down with it. 

% Why have an onCreate ( ) method? Why not just 
put that code inside a constructor? 

Android needs to set up the environment for the activity 
after it’s constructed. Once the environment is ready, Android 
calls onCreate ( ) . That’s why code to set up the screen goes 
inside onCreate ( ) instead of a constructor. 



% Couldn’t I just write a loop in onCreate ( ) to keep 
updating the timer? 

No, onCreate ( ) needs to finish before the screen will 
appear. An endless loop would prevent that happening. 

% runTimer () looks really complicated. Do I really 
need to do all this? 



A: 



t’s a little complex, but whenever you need to schedule code 
like this, the code will look similar to runTimer ( ) . 
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test drive 

Test drive the app 

When we run the app in the emulator, the app works great. We 
can start, stop, and reset the stopwatch without any problems at 
all — the app works just as you’d expect. 



0:00:07 



These buttons work as you d e*pedt- The 
Start button starts the stopwatch, the 
Stop button stops it 2nd the Reset 
button sets the stopwatch badk to O . 



Put there's just one problem... 

When we ran the app on a physical device, the app worked OK 
up until someone rotated the device. When the device was rotated, 
the stopwatch set itself back to 0. 




W A U 09:06 



0:00:12 



The stopwatch was running but jets reset 
when the device is rotated- 




In Androidville, it’s surprisingly common for apps to break when 
you rotate the device. Before we fix the problem, let’s take a closer 
look at what caused it. 
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What just happened? 

So why did the app break when the user rotated the screen? 

Let’s take a closer look at what really happened. 

Q The user starts the app, and clicks on the start button to set the 
stopwatch going. 

The runTimer ( ) method starts incrementing the number of seconds displayed in 
the time_view text view using the seconds and running variables. 







The user rotates the device. 

Android sees that the screen orientation and screen size has changed, and it destroys 
the activity, including any variables used by the runTimer ( ) method. 

A V / 






jo i 
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M i \ 
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/ 



Stopwatch Activity is then re-created. 

The onCreate ( ) method runs again, and the runTimer ( ) method gets called. 
As the activity has been re-created, the seconds and running variables are set to 
their default values. 





is because -tbe activity was 
destroyed and re-treated 
v/ben dcv'i te was rotated • 
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Rotating the screen changes the device configuration 



When Android runs your app and starts an activity, it takes 
into account the device configuration. By this we mean the 
configuration of the physical device (such as the screen size, screen 
orientation, and whether there’s a keyboard attached) and also 
configuration options specified by the user (such as the locale). 



Android needs to know what the device configuration is when it 
starts an activity because it can impact what resources are needed 
for the application. A different layout might need to be used if the 
device screen is landscape rather than portrait, for instance, and a 
different set of string values might need to be used if the locale is 
French. 



Android apps 
dorrfca’m multiple 
resource -Piles m -the 
app/srd/mam/res 
bolder. I-P -the device 
locale is se-t -to Fra^e, 
Android will use -the 
sir'm<js.*ml -Pile m ihe 
values— Pr -Polder, -Por 
ins-tan£e- 



man 
Qjava 
Cares 

B drawable 

► B drawable-hdpi 

► B drawable-mdpi 

► E]d ra wa b I e - xh d p i 

► B drawable-xxhdpi 

► B layout 

► Bmenu 
T Bvalues 

9 dimens. xml 
9 strings. xml 
9 styles.xml 
▼ Bvalues-fr 

[ I strings. xml 

► B values-w820dp 
<> Android Manifs 



The device 

configuration includes 
options specified 
by the user (such 
as the locale), and 
options relating to the 
physical device (such 
as the orientation and 
screen size). A change 
to any of these options 
results in the activity 
being destroyed and 
re-created. 



When the device configuration changes, anything that displays a user 
interface needs to be updated to match the new configuration. If 
you rotate your device, Android spots that the screen orientation and 
screen size has changed, and classes this as a change to the device 
configuration. It destroys the current activity, and then re-creates it 
again so that resources appropriate to the new configuration get picked 

up- 
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From birth to death: the states of an activity 

When Android creates and destroys an activity, the activity moves 
from being launched, to running, to being destroyed. 

The main state of an activity is when it’s running or active. An 
activity is running when it’s in the foreground of the screen, has the 
focus, and the user can interact with it. The activity spends most 
of its life in this state. An activity starts running after it has been 
launched, and at the end of its life, the activity is destroyed. 






Activity running J^y^ activity spe „ds 

mos-i o-f i-ts li-Pe here. 



hi this foiwbj youv 

Activity destroyed activity *o U^ 

exists. 



An activity is running 

when it’s in the 

lore ground ol the screen. 



When an activity moves from being launched to being destroyed, 
it triggers key activity lifecycle methods: the onCreate () and 
onDestroy ( ) methods. These are lifecycle methods that your 
activity inherits, and which you can override if necessary. 

The onCreate () method gets called immediately after your 
activity is launched. This method is where you do all your normal 
activity setup such as calling set Con tent View ( ) . You should 
always override this method. If you don’t override it, you won’t be 
able to tell Android what layout your activity should use. 

The onDestroy () method is the final call you get before the 
activity is destroyed. There are a number of situations in which 
an activity can get destroyed — for example, if it’s been told to 
finish, if the activity’s being re-created due to a change in device 
configuration, or if Android has decided to destroy the activity in 
order to save space. 

We’ll take a closer look at how these methods fit into the activity 
states on the next page. 



onCreateO gets called 
when the activity is first 
eated, and it’s where 



cr 



anc 

you do your normal 
activity setup. 



onDestroyO gets 
just before your 
gets destroyed. 



called 

activity 
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The activity lifecycle: from create to destroy 

Here’s an overview of the activity lifecycle from birth to death. As 
you’ll see later in the chapter, we’ve left out some of the details, 
but at this point we’re just focusing on the onCreate ( ) and 
onDestroyO methods. 





Q The activity gets launched. 

The activity object is created and its constructor 
is run. 



o 



The onCreate() method runs immediately 
after the activity is launched. 

The onCreate () method is where any 
initialization code should go, as this method 
always gets called after the activity has launched 
and before it starts running. 



© 



An activity is running when it's visible in 
the foreground and the user can interact 
with it. 

This is where an activity spends most of its life. 



o 



The onDestroyO method runs immediately 
before the activity is destroyed. 

The onDestroyO method enables you to 
perform any final clean up such as freeing up 
resources. 




Activity destroyed 




© 



After the onDestroyO method has run, 
the activity is destroyed. 

The activity ceases to exist. 
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Your activity inherits the lifecycle methods 

As you saw earlier in the book, your activity extends the android . app . Activity 
class. It’s this class that gives your activity access to the Android lifecycle methods: 




Context abstract class 

(android.content.Context) 

A* interface to global information about the application environment- Allows 
access to application resources, classes, and application-level operations. 

ContextWrapper class 

(android.content.ContextWrapper) 

A proxy implementation -for the Context- 

ContextThemeWrapper class 

(android.view.ContextThemeWrapper) 

The Conte*tThemel/Vrapper allows you -to modify the theme 
-Prom what’s in the Conte*' iMrappev. 

Activity class 

(android.app.Activity) 

The Activity dass implements de-Pault versions o-P 
the li-fecycle methods. |t also de-Pines methods su£h 
as -Pind\/iewBy|d(|nt) and setContent\/iew(\/iew). 



YourActivity class 

(com.hfad.foo) 

Most o-P the behavior o-P your activity is handled 
by superclass methods. AH you do is override 
the methods you need- 
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bypass with caution 



How do we deal with configuration changes? 



As you saw, our app went wrong when the user rotated the screen. The activity 
was destroyed and re-created, which meant that local variables used by the 
activity were lost. So how do we get around this issue? How do we deal with 
device configuration changes such as a change to the screen orientation? 

There are two options: we can either tell Android to bypass restarting the activity, 
or we can save its current state so that the activity can re-create itself in the same 
state. Let’s look at these two options in more detail. 



bypass re-creating the activity 

The first option is to tell Android not to restart the activity if there’s been 
a configuration change. While we’re going to show you how to do this, 
bear in mind that it’s usually not the best option. This is because when 
Android re-creates the activity, it makes sure it uses the right resources for 
the new configuration. If you bypass this, you may have to write a bunch 
of extra code to deal with the new configuration yourself. 

You can tell Android not to re-create an activity due to a configuration 
change by adding a line to the activity element of the AndroidManifest.xml 
file like this: 



Watch it! 



Only deal with 
configuration 
changes this 
way as a last 
resort. 



You’ll bypass built-in Android 
behavior that could cause 
problems. 



android : conf igChange s= " conf igur a t ion_change " 

where conf igur at ion_change is the type of configuration change. 

In our case, we’d want to get Android to bypass a change to the screen 
orientation and screen size, so we’d need to add the following code to the 
A ndroidManifest. xm l file : 



□ 

Stopwatch 

413 

app/src/main 
AndroidManifest.xml 




<activity 



android: name="com. hfad. stopwatch . StopwatchActivity" 
android : label=" @ string/ app_name" 

android: conf igChanges=" orientation | screenSize" > 

If Android encounters this type of configuration change, it makes a call 
to the onConf igurationChanged (Conf iguration) method 
instead of re-creating the activity: 



The | means we need to bypass both 
don^uv-ation dhan^es. This is bedause 
most decides have a vedtan^ulav sdreen, 
so rotating the devi ide dhan^es both 
the orientation and the sdreen siz£. 



public void onConf igurationChanged (Configuration config) { 

} 



You can implement this method to react to the configuration 
change if you need to. 
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Or save the current state... 



The better way of dealing with configuration changes which you’ll use most 
often is to save the current state of the activity, and then reinstate it in the 
onCreate () method of the activity 

To save the current state of the activity, you need to implement the 
onSavelnstanceState ( ) method. The onSavelnstanceState ( ) 
method gets called before the activity gets destroyed, which means you get 
an opportunity to save any values you want to retain before they get lost. 




onCreate() 



The onSavelnstanceState ( ) method takes one parameter, a 
Bundle. A Bundle allows you to gather together different types of data 
into a single object: 

public void onSavelnstanceState (Bundle savedlnstanceState) { 



} 



The onCreate ( ) method gets passed the Bundle as a 
parameter. This means that if you add the values of the running 
and seconds variables to the Bundle, the onCreate ( ) 
method will be able to pick them up when the activity gets re- 
created. To do this, you use Bundle methods to add name/value 
pairs to the Bundle. These methods take the form: 

bundle . put* ( " name " , value ) 




Activity running 




The on£ave|nstan£e£ta-teO 

method gets called ^ 

be-Pore OY\ DestvoyO. onSavelnstanceState() 
li Jives you a 
£han£e to save y our 

onDestroyO 

berore the activity 
is destroyed. 



i 

star 

i 

estr 

i 



where bundle is the name of the Bundle, * is the type of value you 
want to save, and name and value are the name and value of the data. 
As an example, to add the seconds int value to the Bundle, you’d 
use: 




Activity destroyed 




bundle . putlnt ( " seconds " , seconds ) ; 



You can save multiple name/value pairs of data to the Bundle. 
Here’s our onSavelnstanceState ( ) method in full: 



@ Override 

public void onSavelnstanceState (Bundle savedlnstanceState) 
savedlnstanceState .putlnt ("seconds" , seconds); ^ 
savedlnstanceState .putBoolean ( "running" , running) ; \ 



□ 

Stopwatch 

4a 

app/sre/main 

java 

413 



} 

Now that we’ve saved our variable values to the Bundle, we can use 
them in our onCreate ( ) method. 



Save *thc values <£ -the 
seconds and running 
variables to the Bundle- 



com. hfad. stopwatch 



Stopwatch 

Activity.java 
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restore state 



...then restore the state in onCreateO 

As we said earlier, the onCreate () method takes one parameter, a 
Bundle. If the activity’s being created from scratch, this parameter 
will be null. If, however, the activity’s being re-created and there’s been 
a prior call to onSavelnstanceState ( ) , the Bundle object 
used by onSavelnstanceState ( ) will get passed to the activity: 

protected void onCreate (Bundle savedlnstanceState) 



You can get values from Bundle by using methods of the form 

bundle . get* ( "name" ) ; 



□ 

Stopwatch 

43 

app/src/main 

java 

43 

com. hfad. stopwatch 




Stopwatch 

Activity.java 



where bundle is the name of the Bundle, * is the type of value 
you want to get, and name is the name of the name/ value pair you 
specified on the previous page. As an example, to get the seconds 
int value from the Bundle, you’d use: 

int seconds = bundle. getlnt ("seconds") ; 



Putting all of this together, here’s what our onCreate () method 
now looks like: 



protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 

setContentView (R. layout . activity_stopwatch) ; Relieve -the values o-f 

if (savedlnstanceState != null) { ^ seconds and vunninj 

seconds = savedlnstanceState . getlnt ( "seconds" ) ; ^^ va,r,a bles ‘^ ror * -the Bundle- 
running = savedlnstanceState . getBoolean ( "running" ) ; 



} 

runTimer ( ) ; 



So how does this work in practice? 






r 






I )<§ this! 



Make sure you update your 
onCreate() method and add the 
onSavelnstanceState() method. 
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What 

© 



happens when you run the app 

The user starts the app, and clicks on the start button to set the 
stopwatch going. 

The runTimer ( ) method starts incrementing the number of seconds displayed in 
the time view text view. 




© 



The user rotates the device. 

Android views this as a configuration change, and gets ready to destroy the activity 
Before the activity is destroyed, onSavelnstanceState ( ) gets called. The 
onSavelnstanceState ( ) method saves the seconds and running values to a 





bundle 

"seconds'-8 

"running"=+rue 
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what happens 



The story continues 



9 



O 



Android destroys the activity, and then re-creates it. 

The onCreate ( ) method gets called, and the Bundle gets passed to it. 




The Bundle contains the values of the seconds and running variables as 
they were before the activity was destroyed. 

Code in the onCreate ( ) method set the current variables to the values in the Bundle. 



O 




"seconds'-8 

"running'-true 



The runTimer() method gets called, and the timer picks up where it 
left off. 



The stopwatch gets displayed on the device. 
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Test drive the app 

Make the changes to your activity code, then run the app. When 
you click on the Start button, the timer starts, and it continues 
when you rotate the device. 



I Vhen we rotate our device, 
the stopwatch keeps on jo'mj. 




tliereicire no 

Dumb Questions 



Why does Android want to 
re-create an activity just because I 
rotated the screen? 

The onCreate ( ) method is 
normally used to set up the screen. If your 
code in onCreate ( ) depended upon 
the screen configuration (for example, if 
you had different layouts for landscape 
and portrait) then you would want 
onCreate ( ) to be called every time 
the configuration changed. Also, if the user 
changed the locale, you might want to re- 
create the Ul in the local language. 



Why doesn’t Android 
automatically store every instance 
variable automatically? Why do I have 
to write all of that code myself? 

You might not want every instance 
variable stored. For example, you might 
have a variable that stores the current 
screen width. You would want that 
variable to be recalculated the next time 
onCreate ( ) is called. 




Is a Bundle some sort of Java 



No, but it’s designed to work like a 
j ava . ut il . Map. Bundles have 
additional abilities to maps, for example, 
Bundles have the ability to be sent 
between processes. That’s really useful, 
because it allows the Android OS to stay in 
touch with the state of an activity. 
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visible lifecycle 



There's more to an activity's life than create and destroy 

So far we’ve looked at the create and destroy parts of the activity 
lifecycle, and you’ve seen how to deal with configuration changes such 
as a change in the screen orientation. But there are other events in an 
activity’s life that you might want to deal with to get the app to behave 
in the way you want. 

As an example, suppose the stopwatch is running and you get a phone ^ — fat* i-f y° u dor\ *t v-eally 
call. Even though the stopwatch isn’t visible, it will continue running. you\r s'topwa'tfch *to behave 1 c 

But what if you want the stopwatch to stop while it’s hidden, and this, i*t s a <yrea*b e%tuse to oo 

resume once the app is visible again? 3*t mov-e li-Cedytle methods. 



Start stop, and restart 

Fortunately, it’s easy to handle actions that relate to an activity’s 
visibility if you use the right lifecycle methods. In addition to the 
onCreate ( ) and onDestroy ( ) methods, which deal with the 
overall lifecycle of the activity, there are other lifecycle methods 
that deal with an activity’s visibility. 

There are three key lifecycle methods that deal with when an 
activity becomes visible or invisible to the user. These methods 
are onStart ( ) , onStop ( ) , and onRestart ( ) .Just as with 
onCreate ( ) and onDestroy ( ) , your activity inherits them 
from the Android Activity class. 

onStart ( ) gets called when your activity becomes visible to the 
user. 

onStop () gets called when your activity has stopped being 
visible to the user. This might be because it’s completely hidden 
by another activity that’s appeared on top of it, or because the 
activity is going to be destroyed. If onStop ( ) is called because 
the activity’s going to be destroyed, onSavelnstanceState ( ) 
gets called before onStop ( ) . 

onRestart ( ) gets called after your activity has been made 
invisible, before it gets made visible again. 

We’ll take a closer look at how these fit in with the onCreate ( ) 
and onDestroy () methods on the next page. 



An activity has a state ol 
stopped il it’s completely 
hidden hy another activity 
and isn’t visible to the 
user. The activity still 
exists in the background 
and maintains all state 
information. 
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The activity lifecycle: the visible lifetime 



Let’s build on the lifecycle diagram you saw earlier in the chapter, this 
time including the onStart ( ) , onStop ( ) , and onRestart ( ) 
methods (the bits you need to focus on are in bold): 





°i 



o 



© 

© 

© 



The activity gets launched, and the 
onCreate() method runs. 

Any activity initialization code in the 
onCreate () method runs. At this point, the 
activity isn’t yet visible, as no call to onStart () 
has been made. 



The onStart() method runs after the 
onCreate() method. It gets called when 
the activity is about to become visible. 

After the onStart ( ) method has run, the user 
can see the activity on the screen. 



The onStopO method runs when the 
activity stops being visible to the user. 

After the onStop ( ) method has run, the activity 
is no longer visible. 



If the activity becomes visible to the 
user again, the onRestart() method gets 
called followed by onStart(). 

The activity may go through this cycle many times 
if the activity repeatedly becomes invisible and 
visible again. 




Activity destroyed 




Watch it! 



If your device is 
extremely low on 
memory, onStopO might 
not get called before the 
activity is destroyed. 



© 



Finally, the activity is destroyed. 

The onStop ( ) method will usually get called 
before onDestroy ( ) , but it may get bypassed if 
the device is extremely low on memory. 
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stop and start 



We need to implement two more lifecycle methods 



There are two things we need to do to update our Stopwatch app. First, we 
need to implement the activity’s onStop ( ) method so that the stopwatch 
stops running when the app isn’t visible. Once we’ve done that, we need 
to implement the onStart ( ) method so that the stopwatch starts again 
when the app is visible. Let’s start with the onStop ( ) method. 

Implement owStopO to stop the timer 

You override the onStop ( ) method in the Android Activity class by 
adding the following method to your activity: 

@ Override 

protected void onStop () { 

super . onStop ( ) ; 

} 



□ 

Stopwatch 

app/src/main 

41 



java 



m3 



com. hfad. stopwatch 



Stopwatch 

Activity.java 



Whenever you override one of the Android lifecycle methods, it’s 
important that you first call up the onStop ( ) method in the superclass 
using: 



super . onStop ( ) ; 



There are a couple of reasons for this. First, you need to make sure that the 
activity gets to perform all of the actions in the superclass lifecycle method. 
Second, Android will never forgive you if you bypass this step — it will 
generate an exception. 

We need to get the stopwatch to stop when the onStop ( ) method is 
called. To do this, we need to set the value of the running boolean to 
false. Here’s the complete method: 

@ Override 

protected void onStop () { 

super . onStop ( ) ; 
running = false; 

} 



When you override 
an activity 
lilecycle method, 
you need to call the 
superclass method. 
II you don’t, you’ll 
gfet an exception. 



So now the stopwatch stops when the activity is no longer visible. The next 
thing we need to do is get the stopwatch to start again when the activity 
becomes visible. 
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Now it's your turn. Change the activity code so that if the 
stopwatch was running before onStop () was called, it starts 
running again when the activity regains the focus. 



public class StopwatchActivity extends Activity { 
private int seconds = 0; 
private boolean running; 



@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_stopwatch) ; 
if (savedlnstanceState != null) { 

seconds = savedlnstanceState . getlnt ( "seconds" ) ; 
running = savedlnstanceState . getBoolean ( "running" ) ; 

} 

Here's the tirst part of the adtwity dode_ 
Vow'll need to implement the onStartO ">ethod 
and dhan^e other methods slightly too. 

public void onSavelnstanceState (Bundle savedlnstanceState) { 
savedlnstanceState .putlnt ( "seconds" , seconds) ; 
savedlnstanceState . putBoolean ( "running" , running) ; 
savedlnstanceState . putBoolean ( "wasRunning" , wasRunning) ; 



runTimer ( ) ; 

} 

@Override 



@Override 

protected void onStop () { 

super . onStop ( ) ; 
running = false; 

} 
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sharpen solution 




Now it's your turn. Change the activity code so that if the 
stopwatch was running before onStop () was called, it starts 
running again when the activity regains the focus. 



public class StopwatchActivity extends Activity { 
private int seconds = 0; 
private boolean running; 

private boolean wasRurmirg; 



We added a new variable, wasRurm'mg, -to record whether 
^the s-topwateh was running be-Pore the onStopO method 
was called so that we know whether -to set it running 
again when the activity becomes visible again. 

@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_stopwatch) ; 
if (savedlnstanceState != null) { 

seconds = savedlnstanceState . getlnt ( "seconds" ) ; 
running = savedlnstanceState . getBoolean ( "running" ) ; 

wasRunning =■ saved InstandeState.getBooleanO wasRunning”); 

} 

runTimer ( ) ; We'll restore tbe state o£ the wasfW'm<) 

j variable i-P tbe activity is re-dreated- 



@Override 

public void onSavelnstanceState (Bundle savedlnstanceState) { 
savedlnstanceState . put Int ( "seconds" , seconds ) ; 
savedlnstanceState . putBoolean ( "running" , running) ; 

saved|r\s*tar\de£*ta*te pu*tBooleah( u wasRur\r\'mg w , wasRurmmg); ^ — £ avc s-ta-tc o-P -the 

} wasRurm'mg variable- 

@Override 

protected void onStop () { 

super . onStop ( ) ; R etoy .<J whether tbe stopwatdh was running 

wasIWi^ - rurmir^ ^ ^be onStopO method was tailed- 

running — false; 

} 



^Override 



pro*ted*ted void om£-tar-tO { 
super. or\£*tar*tO; 

i-P (wasRuhh’mg) { 

rurm'mg — -true; 

} 



Implement ihe onS-fcar-tO 
meihod- I-P -the s-topy/aieh was 
running, sei ii running again. 



} 
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The updated StopwatchActivity code 



We updated our activity code so that if the stopwatch was running 
before it lost the focus, it starts running again when it gets the focus 
back. Make the changes to your code: 



□ 

Stopwatch 

H3 



public class StopwatchActivity extends Activity { 

private int seconds = 0; A new variable, wasRurming, records 

private boolean running; whether ‘the s-fcopwaidb was running be-Pore 

private boolean wasRunning; ^ ^ i^ c cmSiopO rneihod was called so ibai 

we know wheiher io sei ii running again 

@ Override wbcn "the aeiiviiy bcdoi^es visible again- 

protected void onCreate (Bundle savedlnstanceState ) { 

super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_stopwatch) ; 
if (savedlnstanceState != null) { 

seconds = savedlnstanceState . getlnt ("seconds" ) ; 
running = savedlnstanceState . getBoolean ( "running" ) ; 
wasRunning = savedlnstanceState . getBoolean ( "wasRunning" ) ; 

} ^ 

runTimer ( ) ; Restove -the state ok the wasRurmmg 

} vaviable it the activity is ve-cveated 



app/src/main 

HTJ 



java 






com . hfad .stopwatch 

L @ 

Stopwatch 

Activity.java 



@Override 

public void onSavelnstanceState (Bundle savedlnstanceState) { 
savedlnstanceState . putlnt ( "seconds", seconds) ; 
savedlnstanceState . putBoolean ( "running", running) ; 

savedlnstanceState .putBoolean ( "wasRunning" , wasRunning) ; ^ g^ s-ta-tc 
^ wasRunning variable- 



ibe 



@ Override 

protected void onStopO { 

super . onStop ( ) ; Redovd whethev the stopwatch was vunmng 

wasRunning = running; ^ 0 «StopO method was Called- 

running = false; 

} 



@ Override 



protected void onStart() { 
super . onS tart ( ) ; K. 

if (wasRunning) { 
running = true ; 

} 



Implemeni ibe onSiariO 
meihod- |*f ibe s-fcopwaieb was 
running, sei ii running again- 



} 
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what happens 



What 

© 



happens when you run the app 

The user starts the app, and clicks the Start button to set the stopwatch going. 

The runTimer ( ) method starts incrementing the number of seconds displayed in the time_view 



text view. 





Q 



The user navigates to the device home screen so the Stopwatch app is no longer 
visible. 



The onStop ( ) method gets called, wasRunning is set to true, running is set to false, and the 
number of seconds stops incrementing. 



The ad: ivrty still 
exists even though 
its not visible- 





Stopwatch 

Activity 



seconds=16 

O running is set 

Ac — to -false in the 

. onStopO method- 
running=ralse r 



wasRunning=true 



o 



The user navigates back to the Stopwatch app. 

The onStart ( ) method gets called, running is set to true, and the number of seconds starts 
incrementing again. 




Device 




seconds=16 



Stopwatch 

Activity 



running=true 

u 

wasRunning=false 



running is set 
to true in the 
onStart 0 m ethod- 
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Test drive the app 

Save the changes to your activity code, then run the app. When 
you click on the Start button the timer starts, it stops when the 
app is no longer visible, and it starts again when the app becomes 
visible again. 




there i are no 

Dumb Questions 



Q: Could we have used the onRes tart ( ) method 
instead? 



onRes tart ( ) is used when you only want code to 
run when an app becomes visible after having previously been 
invisible. It doesn’t run when the activity becomes visible for the 
first time. In our case, we wanted the app to still work when we 
rotated the device. 




should that make a difference? 



When you rotate the device, the activity is destroyed 
and a new one is created in its place. If we’d put code in the 
onRes tart ( ) method instead, it wouldn’t have run when the 
activity was re-created. The onStart ( ) method gets called in 
both situations. 
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foreground lifecycle 



Put what if an app is only partially visible? 

So far you’ve seen what happens when an activity gets created and 
destroyed, and you’ve also seen what happens when an activity 
becomes visible, and when it becomes invisible. But there’s one more 
situation we need to consider: when an activity’s visible but doesn’t 
have the focus. 

When an activity is visible but doesn’t have the focus, the activity is 
paused. This can happen if another activity appears on top of your 
activity that isn’t full-size or that’s transparent. The activity on top has 
the focus, but the one underneath is still visible and is therefore paused. 



WA □ 09:45 



0:00:15 



Walk dog 

Any.do Reminder 



® © 0 





The s-topwa-teh 

activity is siill 
-visible, bui 
i-t's partially 
observed a^d no 
longer bas -the 
-Podus. 



This is an 
activity -fr Ota 

ano-lher app 
-that's appeared 



An activity has a 
state of paused if it’s 
lost the locus but is 
still visible to the 
user. The activity 
is still alive and 
maintains all its state 
information. 



There are two lifecycle methods that deal with when the activity 
is paused and when it becomes active again: on Pause ( ) and 
onResume ( ) . on Pause ( ) gets called when your activity is visible 
but another activity has the focus. onResume ( ) is called immediately 
before your activity is about to start interacting with the user. If you 
need your app to react in some way when your activity is paused, you 
need to implement these methods. 

You’ll see on the next page how these methods fit in with the rest of the 
lifecycle methods you’ve seen so far. 
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The activity lifecycle: the foreground lifetime 



Let’s build on the lifecycle diagram you saw earlier in the chapter, this 
time including the onResume ( ) and on Pause ( ) methods (the new 
bits are in bold): 




Activity launched 




i 



© 

onCreate() 



i 




©1 




Activity destroyed 




Q The activity gets launched, and the 

onCreate() and onStart() methods run. 

At this point, the activity is visible, but it doesn’t 
have the focus. 

Q The onResume() method runs after the 
onStart() method. It gets called when 
the activity is about to move into the 
foreground. 

After the onResume ( ) method has run, the 
activity has the focus and the user can interact 
with it. 



© 

o 



The onPause() method runs when the 
activity stops being in the foreground. 

After the onPause ( ) method has run, the 
activity is still visible but doesn’t have the focus. 

If the activity moves into the 
foreground again, the onResume() 
method gets called. 

The activity may go through this cycle many times 
if the activity repeatedly loses and regains the 
focus. 



o 

o 

o 



If the activity stops being visible to the 
user, the onStopO method gets called. 

After the onStop ( ) method has run, the activity 
is no longer visible. 

If the activity becomes visible to the 
user again, the onRestart() method 
gets called, followed by onStart() and 
onResume(). 

The activity may go through this cycle many times. 

Finally, the activity is destroyed. 

As the activity moves from running to destroyed, 
the onPause ( ) method gets called before the 
activity is destroyed. The onStop ( ) method 
usually gets called too. 
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rotation 




Earlier on you talked about how 
the activity is destroyed and a new one is 
created when the user rotates the device. 
What happens if the activity is paused when 
the device is rotated? Does the activity go 
through the same lifecycle methods? 



That’s a great question, so let’s look at this in more 
detail before getting back to the Stopwatch app. 



The original activity goes through all its lifecycle methods, from 
onCreate ( ) to onDestroy ( ) . A new activity is created when the 
original is destroyed. As this new activity isn’t in the foreground, only 
the onCreate () and onStart ( ) lifecycle methods get called: 



Original Activity 



(tctivIlY launched^) 

~~T 

onCreate() 

onStart() 

i 

onResume() 

i 



(tcttvity runndt) 

onPause() 



© 



The user launches the activity. 

The activity lifecycle methods onCreate (), 
onStart ( ) , and onResume ( ) get called. 



o 



Another activity appears in front of 
it. 

The activity onPause ( ) method gets called. 



o 



The user rotates the device. 

Android sees this as a configuration change. 
TheonStopO and onDestroy ( ) 
methods get called, and Android destroys the 
activity. A new activity is created in its place. 



o 



The activity is visible but not in the 
foreground. 

The onCreate ( ) and onStart ( ) 
methods get called. As the activity is 
only visible and doesn’t have the focus, 



onStop() 

i 



on Destroy () 



onResume ( ) isn’t called. 

Replacement Activity 
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I see , the replacement activity doesn't reach 
a state of "running" because it's not in the 
foreground. But what if you navigate away from 
the activity completely so it's not even visible? 
If the activity's stopped, do onResume() and 
onPauseQ get called before onStopQ? 



Activities can go 
straight from onStart() 
to onStop() and 
bypass onPause() and 
onResume(). 

If you have an activity that’s 
visible, but never in the 
foreground and never has the 
focus, the onPause ( ) and 
onResume ( ) methods never 
get called. 

The onResume ( ) method gets 
called when the activity appears 
in the foreground and has the 
focus. If the activity is only 
visible behind other activities, 
the onResume ( ) method 
doesn’t get called. 

Similarly, the onPause ( ) 
method gets called when the 
activity is no longer in the 
foreground. If the activity is 
never in the foreground, this 
method won’t get called. 




It a* activity stops or detroyed beW ^ 
i*t appears in the -foreground, “the onS'tar'tO 
method is -followed by the onStopO method- 
onResumeO and onPauseO are bypassed- 



onCreate() 



i 



-onStart() 



i 



-> onResume() 




Activity running 




i 



■ onPause() 



i 



-> onStop() 



i 



on Destroy () 



i 




Activity destroyed 




onRestart() 
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Stop the stopwatch if the activity's paused 

Let’s get back to the Stopwatch app. 



i 

onStart() 4 



So far we’ve made the stopwatch stop if the Stopwatch app isn’t 
visible, and made it start again when the app becomes visible 
again. In addition to this, let’s get the stopwatch to stop if the 
activity is paused, and start again when the activity is resumed. 
So which lifecycle methods do we need to implement? 

The easy answer is that we need to use the on Pause ( ) 
and onResume ( ) methods, but we can take this one step 
further. We’ll use these methods to replace the calls 
to onStop ( ) and onStart ( ) that we’ve already 
implemented. If you look again at the lifecycle diagram, 
calls are made to onPause ( ) and onResume ( ) in addition to 
onStop () and onStart ( ) whenever an activity is stopped 
and started. We’ll use the same methods for both situations as 
we want the app to behave in the same way. 

Here’s our version of the onPause ( ) method: 



©Override 

protected void onPause () 
super . onPause ( ) ; 



□ 

Stopwatch 

kd 



1 




I 



onStop() 

i 



onRestartQ 



wasRunning = running; 
running = false; 

} 

And here’s the onResume ( ) method: 

©Override 

protected void onResume () { 

super . onResume ( ) ; 
if (wasRunning) { 
running = true; 

> 



app/src/main 
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java 



MU 



com . hfad .stopwatch 



Stopwatch 

Activity.java 




} Replace the onStop() and 

onStart() methods in your 

So let’s see what happens when we run the app. code with the onPause() and 

onResumeQ methods shown here. 
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What 

© 



happens when you run the app 

The user starts the app, and clicks on the start button to set the stopwatch going. 

The runTimer ( ) method starts incrementing the number of seconds displayed in the time_view 



text view. 





Device 



<s> Another activity appears in the foreground, leaving Stopwatch Activity partially visible. 

The onPause ( ) method gets called, wasRunning is set to true, running is set to false, and the 
number of seconds stops incrementing. 



The activity is paused^^ 
as it ; s visible but not 
in the -foreground- ^ 




Device 



running is set 

_ to -false in the 

Stopwatch \ running=false OftPawse0 melho d. 

Activity 

wasRunning=true 



© 



When Stopwatch Activity returns to the foreground, the onResume() method gets 
called, running is set to true, and the number of seconds starts incrementing 
again. 









3 




9 <9 


Device 




running is set 
to true in the 
onResumeO method- 
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Test drive the app 



Save the changes to your activity code, then run the app. When 
you click on the Start button, the timer starts; it stops when the 
app is partially obscured by another activity, and it starts again 
when the app is back in the foreground. 



0:00:41 




Wc started ou\r s-fcopwaidk 
li paused when -the activity 
was partially obseuved- 



0:03:01 



ft 

0:03:26 






Walk dog 

Any.do Reminder 




A 


< 


O 


□ 


© 


Q 


0 


w/KM m 






DISMISS 


SNOOZE 


DONE! 








<1 


o 


□ 



therei are no 

Dumb Questions 



The stop\w*Uh stav-ted aja'm 
when the adtivi-ty ta»>e batk 
mto the tov-egv-ouhd- 



<1 o □ 



Q/As some of the lifecycle methods aren’t always called, it 
sounds like this can lead to some flaky apps. Is that right? 

In certain circumstances, Android may choose not to call 
methods like onStop ( ) and onPause ( ) . These methods 
usually contain code to clean up the app. 



onCreate ( ) and onStart ( ) will always be called at the 
correct time, and this means that your app can also make sure it 
begins in the right shape. That’s far more important. 

The key thing is that you really get which lifecycle methods get 
called under what circumstances. 
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The complete activity code 



Here’s the full StopwatchActivity.java code for the finished app: 



package com. hfad. stopwatch; 

import android. os . Bundle; 
import android. os . Handler ; 
import android. app .Activity; 
import android. view. View; 
import android . widget . TextView; 



□ 

Stopwatch 

4B 

app/src/main 

java_ 

MM 



public class StopwatchActivity extends Activity { 

//Number of seconds displayed on the stopwatch, 
private int seconds = 0; 

//Is the stopwatch running? 

private boolean running; 0* stopwatch 

Vr<r » 



' Use seconds, rurmmfy and wasRunning "to redord 
. -the number sedonds passed, whether the 



private boolean wasRunning; 



was running b e-fore the activity was paused- 



com, hfad. stopw atch 



Stopwatch 

Activity.java 



@0verride 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_stopwatch) ; 
if (savedlnstanceState != null) { 

seconds = savedlnstanceState . getlnt ( "seconds" ) ; 
running = savedlnstanceState . getBoolean ( "running" ) ; 
wasRunning = savedlnstanceState . getBoolean ( "wasRunning" ) ; 

} 

runTimer ( ) ; 



-the previous state o-C -the 
stopwatch i-f -the activity's been 
destroyed and re-created- 



QOverride l-f the activity's pawed, stop the stopwatch. 

protected void onPause () { 

super . onPause ( ) ; 
wasRunning = running; 
running = false; 

} 

@0verride 

protected void onResume () 
super . onResume ( ) ; 
if (wasRunning) { 
running = true; 

} 

} 



{ $ tbc adtivity s resumed, start 

tbe stopwatdh again i-f it was 
running previously. 



The adtivity 

Co At dontinues 
over -the page- 
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The activity code (continued) 



Save -the state o-f the stopwatch '■£ 
^ it's about to be destroyed- 



@Override 

public void onSavelnstanceState (Bundle savedlnstanceState ) { 

savedlnstanceState .putlnt ( "seconds" , seconds) ; 
savedlnstanceState . putBoolean ( "running" , running) ; 
savedlnstanceState . putBoolean ( "wasRunning", wasRunning) ; 



//Start the stopwatch running when the Start button is clicked, 
public void onClickStart (View view) { 
running = true; *L- 



• This jets called whew the Stavt button is clicked- 



//Stop the stopwatch running when the Stop button is clicked, 
public void onClickStop (View view) 
running = false; 



^ This $eb tailed when the Stop button is tlitked- 



This geb tailed when the Reset button is tlitked- 



//Reset the stopwatch when the Reset button is clicked, 
public void onClickReset (View view) { 
running = false; 

seconds 0 , The v*unTimcv*0 method uses a Randles to intvement 

■ the seconds and update the tey-t view- 






//Sets the number of seconds on the timer, 
private void runTimer () { 

final TextView timeView = (TextView) findViewByld (R . id . time_view) ; 
final Handler handler = new Handler (); 
handler . post (new Runnable () { 

OOverride 



public void run() { 

int hours = seconds/3600; 

int minutes = (seconds%3600 ) / 60 ; 

int secs = seconds%60; 

String time = String . format ( "%d: %02d: %02d" 
hours, minutes, secs) ; 
timeView. setText (time) ; 
if (running) { 
seconds++; 

} 

handler .postDelayed (this, 1000) ; 



□ 



Stopwatch 



app/sre/main 

L o 



java 



MU 



com . hfad . stopwatch 

L e 

Stopwatch 

Activity.java 



} 



}) ; 



} 
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BE ffie i\efMfy 

On the right, you’ll See some activity 
code. Your job is to play like you’re 
the activity and say which 
code will run in each 
of the situations below. 
We’ve labeled the code 
we want you to consider. 
We’ve done the first one to 
Start you off. 



User starts the activity and starts using it. 

Code segments At $t D- The adtivity is dv-eated, 
then it’s made visible, then it vedeives the -fodus. 



class MyActivity extends Activity! 

protected void onCreate ( 

Bundle savedlnstanceState) { 
//Run code A 



protected void onPause () { 

//Run code B 



protected 

//Run 



void onRestart() { 
code C 



User starts the activity, starts using it, 

then Switches to another app. protected void onResume ( ) { 

^ //Run code D 

} 



^-TWis one’s tow 3 Vi ■ 

User starts the activity, starts using it, 
rotates the device, switches to another 
app, then goes back to the activity. 



protected 

@ //Run 

v 



void onStopO 
code E 



{ 



protected 
//Run 

} 




void onRecreate () { 

code F 



protected void onStart() { 
//Run code G 

} 



protected 
//Run 



© 



void onDestroyO { 
code H 
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solution 




BE tb&JSptMty §©lufl©n 

On the right, you’ll See some activity 
code. Your job is to play like you’re 
the activity and say which 
code will run in each 
of the situations below. 
We’ve labeled the code 
we want you to consider. 
We’ve done the first one to 
Start you off. 



User starts the activity and starts using it. 

Code segments At $t V- The adtivity is dreated, 
then it^s made visible, the* it redeives -the -Podus. 



class MyActivity extends Activity! 



protected void onCreate ( 

Bundle savedlnstanceState) { 
//Run code A 



protected void onPause () { 

//Run code B 



protected 

//Run 



void 

code 



onRestart() { 
C 



User starts the activity, starts using it, 
then switches to another app. 

Code segments At $t Vt B, E- The adtivity is 
dreat ed, then its made visible and redeives -the 
-Podus. When the user switdhes to another app, 
it loses the -Podus and is no longer visible to the 
user 

User starts the activity, starts using it, 
rotates the device, switches to another 
app, then goes back to the activity. 

Code segments At 4 Vt B, E, H, At $t Vt B, E, 

C, £j, V- First, the adtivity is dreated, made 
visible, and redeives the -Podus. I/Vhen the devide 
is rotated, the adtivity loses the -Podus, stops 
being visible, and is destroyed- |t*s then dreated 
again, made visible, and redeives the -Podus. I/Vhen 
the user sv/itdhes to another app and badk 
again, the adtivity loses the -Podus, loses visibility, 
bedomes visible again, and regains the -Podus. 



} 

protected void onResume () { 

Q //Run code D 

} 



protected void onStopO 
//Run code E 



o 






There ; s no li-fedydle 
method dalled 

onRedreatcO. 



protected void onRecreate () { 

//Run code F 

} 



protected void onStartO { 
//Run code G 

} 



protected 
//Run 



© 



void 

code 



onDestroyO { 
H 
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Your handy guide to the lifecycle methods 



Method 


When it’s called 


Next method 


onCreateO 


When the activity is first created. Use it for normal 
static setup, such as creating views. It also gives 
you a Bundle giving the previously saved state 
of the activity. 


onStart ( ) 


onRestartQ 


When your activity has been stopped just before 
it gets started again. 


onStart ( ) 


onStartO 


When your activity is becoming visible. It's 
followed by onResume ( ) if the activity comes 
into the foreground, or onStop ( ) if the activity 
is made invisible. 


onResume ( ) or 
onStop ( ) 


onResume Q 


When your activity is in the foreground. 


onPause ( ) 


onPause Q 


When your activity is no longer in the foreground 
because another activity is resuming. The next 
activity isn't resumed until this method finishes, 
so any code in this method needs to be quick. It's 
followed by onResume ( ) if the activity returns 
to the foreground, or onStop ( ) if it becomes 
invisible. 


onResume ( ) or 
onStop ( ) 


onStopQ 


When the activity is no longer visible. This can be 
because another activity is covering it, or because 
the activity's being destroyed. It's followed by 
onRestart ( ) if the activity becomes visible 
again, or onDestroy ( ) if the activity is going 
to be destroyed. 


onRestart ( ) or 
onDestroy ( ) 


onDestroyC) 


When your activity is about to be destroyed or 
because the activity is finishing. 


None 
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toolbox 




Your Android Toolbox 



You’ve got Chapter 4 under 
your belt and now you’ve 
added the activity lifecycle to 
your toolbox. 



You tan download 
-the -full tode -fov 
the thaftev- £v-om 
https : //-t'nyuV-Uom/ 
Headf" iv-stAndvoid- 




BULLET POINTS 



■ Each app runs in its own process by default. 



■ Only the main thread can update the user 
interface. 



■ Use a Handler to schedule code, or post code 
to a different thread. 



■ A device configuration change results in the 
activity being destroyed and re-created. 

■ Your activity inherits the lifecycle methods from the 
Android Activity class. If you override any of 
these methods, you need to call up to the method 
in the superclass. 

■ onSavelnstanceState (Bundle) 

enables your activity to save its state before the 
activity gets destroyed. You can use the Bundle 
to restore state in onCreate ( ) . 

■ You add values to a Bundle using 
bundle .put* ( "name" , value). 

You retrieve values from the bundle using 

bundle . get* ( "name" ) . 

■ onCreate () and onDestroy (), deal with 
the birth and death of the activity. 

■ onRestart ( ) , onStart ( ) and 
onstop ( ) deal with the visibility of the activity. 

■ onResumeO andonPause() deal with 
when the activity gains and loses the focus. 




Activity launched 




T 



onCreate() 



j 



-onStart() 4 - 



i 




due 

I 



-> onStop() 



i 



on Destroy () 



i 



Activity destroyed 





onRestart() 
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^ Enjoy the View + 




Let’s face it, you need to know how to create great layouts. 

If you’re building apps you want people to use, you need to make sure they look just the 
way you want. So far we’ve only scratched the surface when it comes to creating layouts, 
so it’s time to look a little deeper. We’ll introduce you to more types of layout you can 
use, and we’ll also take you on a tour of the main GUI components and how you use 
them. By the end of the chapter, you’ll see that even though they all look a little different, 
all layouts and GUI components have more in common than you might think. 



this is a new chapter 
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Your user interface is made up of 
layouts and (MJI components 

As you already know, a layout defines what a screen looks like, and 
you define it using XML. Layouts usually contain GUI components 
such as buttons and text fields. Your user interacts with these to make 
your app do something. 

All the apps you’ve seen in the book so far have used relative layouts, 
but there are other types of layout you can use as well to get your app 
to look exactly how you want. 




In this chapter, we’re going to introduce some of the other 
layouts you’ll want to use in your apps, and also more of the GUI 
components you can use to make your app more interactive. Let’s 
start with the layouts. 
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Three key layouts: 
relative, linear, and grid 



Layouts come in several flavors, and each one has their own policy to 
follow when deciding where to position the views it contains. Here are 
three of the key ones. Don’t worry about the details for now, over the 
next few pages we’re going to take you through each one. 



Relativelayout 

A relative layout displays its views in relative 
positions. You define the position of each view 
relative to other views in the layout, or relative to 
its parent layout. As an example, you can choose to 
position a text view relative to the top of the parent 
layout, a spinner underneath the text view, and a 
button relative to the bottom of the parent layout. 



Lmearlayout 

A linear layout displays views next to each other 
either vertically or horizontally. If it’s vertically, 
the views are displayed in a single column. If it’s 
horizontally, the views are displayed in a single row. 



(rridlayout 

A grid layout divides the screen into a grid of rows, 
columns, and cells. You specify how many columns 
your layout should have, where you want your views 
to appear, and how many rows or columns they 
should span. 



Views dan be f laded 
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relative layout 



Relativelayout displays views 
in relative positions 

As you already know, a relative layout allows you to position views 
relative to the parent layout, or relative to other views in the layout. 

You define a relative layout using the <RelativeLayout> 
element like this: 

Ti^is “tells /Wvoid — <RelativeLayout xmlns : android="http : //schemas . android.com/apk/res/android" 

youv-e <*sm$ a android: layout_width="match_parent'Y The layout_v/id-tb and layouOiei^U syetity 

relative layout android: layout_height=' "match jarent"^^ you want the layout to be. 

‘ ‘ > ^ There may be other attributes too- 
</RelativeLayout> 



RelativeLayout 

LinearLayout 

GridLayout 



The xmlns : android attribute is used to specify the Android 
namespace, and you must always set it to "http : / /schemas . 
android. com/ apk/ res/ android". 



You MUST set the layout width and height 

The android: layout_width and 
android : layout_height attributes specify how wide 
and high you want the layout to be. These attributes 
are mandatory for all types of layout and view. 

You can set android : layout_width and 
android: layout_height to "match_parent", 
M wrap_content" or a specific size such as lOdp - 10 
density-independent pixels. "wrap_content" means 
that you want the layout to be just big enough to hold all of 
the views inside it, and "match_parent " means that you 
want the layout to be as big as its parent — in this case, as 
big as the device screen minus any padding. You will usually 
set the layout width and height to "match_parent ". 

You may sometimes see android: layout_width and 
android : layout_height set to " f ill_parent ". 

" f ill_parent " was used in older versions of Android, 
and if s now replaced by "match_parent ". "fill_ 
parent" is deprecated. 




Geejc Bjpy 



What are density-independent pixels? 

Some devices create very sharp images 
by using very tiny pixels. Other devices 
are cheaper to produce because they 
have fewer, larger pixels. You use 
density-independent pixels (dp) to 
avoid creating interfaces that are overly 
small on some devices, and overly large 
on others. A measurement in density- 
independent pixels is roughly the same 
size across all devices. 
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Adding padding 

If you want there to be a bit of space around the edge of the layout, 
you can set padding attributes. These attributes tell Android how 
much padding you want between each of the layout's sides and its 
parent. Here’s how you would tell Android you want to add padding 
of 1 6dp around all edges of the layout: 

<RelativeLayout . . . 

android : paddingBottom= M 16dp M 
android :paddingLeft="16dp" / 

android :paddingRight= M 16dp M r* ^dd padd’m^ o£ IMf- 
android : paddingTop= " 1 6dp " > 



</RelativeLayout> 

The android : padding* attributes are optional, and you can use 
them with any layout or view. 

In the above example, we’ve hardcoded the padding and set it 
to 1 6dp. An alternative approach is to specify the padding in a 
dimension resource file instead. Using a dimension resource file 
makes it easier to maintain the padding of all the layouts in your app. 



the user interface 

RelativeLayout 

LinearLayout 

GridLayout 




You use a dimension resource file by setting the padding attributes in 

your layout file to the name of a dimension resource like this: The paddmjLe-ft and 

paddinf\Ri<\ht attributes 

<RelativeLayout ... ^ ^ ^ ^aimcn/afttivrby_ 

android : paddingLeft="@dimen/activity_horizontal_margin M J horizontal margin- 

android : paddingRight=" @dimen/activity_horizontal_margin" 



android : paddingTop="@dimen/activity_vertical_margin 
android : paddingBottom="@dimen/activity_vertical_margin"> 



Android then looks up the values of the attributes at runtime in the 
dimension resource file. This file is located in the app /src /main/res/ 
values folder, and it’s usually called dimens. xml: 



The paddingTop and 
paddmgBotfcor* attributes 
are set to @d\ me*/ adtivity__ 
verti£al_j*ar<yn. 



<resources> 

<dimen name="activity_horizontal_margin">16dp</dimen> 
<dimen name= M activity_vertical_margin M >16dp</dimen> ^ 
</resources> 



The layout looks up the 
padding values -from these 
dWn resources. 



When you create a new Android Studio project and add an activity to 
it, the IDE will usually create this for you. 
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relative to parent 

Positioning views relative to the parent layout 

When you use a relative layout, you need to tell Android where you want 
its views to appear relative to other views in the layout, or to its parent. A 
view’s parent is the layout that contains the view 

If you want a view to always appear in a particular position on the screen, 
irrespective of the screen size or orientation, you need to position the view 
relative to its parent. As an example, here’s how you’d make sure a button 
always appears in the top-right corner of the layout: 



RelativeLayout 

LinearLayout 

GridLayout 



f 



The layout 

don*tains the 
button, so the 
layout is the 
buttons parent 



<RelativeLayout ... > 

<Button 

android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android : text=" @ string/ click_me" 

android : layout_alignParentTop= M true " 
android : layout_alignParentRight= M true " 

</RelativeLayout> 



The 
parent 
layout 



/> 



lay°ut_alignParent7op 

V 






The ehild view. 




layout^ali^nParentR'^ht 



The lines of code 



android: layout_alignParentTop="true" 
android : layout_alignParentRight="true M 

mean that the top edge of the button is aligned to the top edge of the 
layout, and the right edge of the button is aligned to the right edge of the 
layout. This will be the case no matter what the screen size or orientation 
of your device: 
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Attributes for positioning views 
relative to the parent layout 

Here are some of the most common attributes for positioning 
views relative to their parent layout. Add the attribute you want 
to the view you’re positioning, then set its value to "true": 

android: attribute="true" 



RelativeLayout 

LinearLayout 

GridLayout 



Attribute 

android: 

layout.alignParentBottom 



android: 

layout_alignParentLeft 



android: 

layout.alignParentRight 



android: 

layout.alignParentTop 



android: 

layout.centerlnParent 



android: 

layout.centerHorizontal 



android: 

layout_centerVertical 



What it does 

Aligns the bottom edge of the view 
to the bottom edge of the parent. 



Aligns the left edge of the view to 
the left edge of the parent. 



Aligns the right edge of the view to 
the right edge of the parent. 



Aligns the top edge of the view to 
the top edge of the parent. 



Centers the view horizontally and 
vertically in the parent. 



Centers the view horizontally in the 
parent. 



Centers the view vertically in the 
parent. 



The view is , 
the parent 2 
bottom edg 

ir 


aligned to 
; le-Pt and 

es. 


<- 


CLICK ME 






\ 


/ 





CLICK ME 



t 

The view is aligned 
to -the parents right 
and -top edges. 
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relative to siblings 

Positioning views relative to other views 

In addition to positioning views relative to the parent layout, you can also 
position views relative to other views. You do this when you want views to 
stay aligned in some way, irrespective of the screen size or orientation. 

In order to position a view relative to another view, the view you’re using 
as an anchor must be given an ID using the android : id attribute: 

android: id= M @+id/button click me" 



RelativeLayout 

LinearLayout 

GridLayout 



The syntax " @ + id" tells Android to include the ID as a resource in its 
resource file R.java. If you miss out the " + ", Android won’t add the ID as 
a resource and you’ll get errors in your code. 



Here’s how you create a layout with two buttons, with one button 
centered in the middle of the layout, and the second button positioned 
underneath the first: 

VVcVc usin^ “this button as an anfcbov 
<RelativeLayout . . . > jj^ second one, so it needs an 

<Button IP- 

android : id=" @+id/button_click_me" 

android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android : layout_centerInParent=" true" 
android: text="@string/ click_me" /> 



<Button 

android : layout_width="wrap_content" 

android: layout_height="wrap_content " //^ 

android : layout_alignLef t=" @+id/button_click_me" 
android : layout_below=" @+id/button_click_me" 

android: text="@string/new_button_text" /> 
</RelativeLayout> 




The lines 

android : layout_alignLef t=" @+id/button_click_me" 
android : layout_below=" @+id/button_click_me" 

ensure that the second button has its left edge aligned to the left edge of 
the first button, and is always positioned beneath it. 
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Attributes for positioning views 
relative to other views 

Here are some more of the attributes you can use when positioning 
views relative to another view. Add the attribute to the view you’re 
positioning, and sets its value to the view you’re positioning relative to: 

android : attribute=" @+id/ view id" 



RelativeLayout 

LinearLayout 

GridLayout 



Attribute 

android:layout_above 



android:layout_below 



What it does 

Put the view above the view you're anchoring 
it to. 



Puts the view below the view you're anchoring 
it to. 



Y^our view goes above 

V? 




The view youVe 
andbormg i-t "to 






Vouv view 
goes below 



android:layout_alignTop Aligns the top edge of the view to the top 

edge of the view you're anchoring it to. 



android:layout_alignBottom Aligns the bottom edge of the view to the 

bottom edge of the view you're anchoring it to. 



CLICK ME 



'3 



ig* ibe view's i of edges 
Align ibe view’s boibor* edges 



CLICK ME 



i 



android:layout_alignLeft Aligns the left edge of the view to the left 

edge of the view you're anchoring it to. 



android:layout_alignRight Aligns the right edge of the view to the right 

edge of the view you're anchoring it to. 



CLICK ME 



Align ibe 

view’s le-Ci 
edges 



CLICK ME 



Align -the 
view’s righi 
edges 



android:layout_toLeftOf 



Puts the right edge of the view to the left of 
the view you're anchoring it to. 



CLICK ME 



Your view goes io ibe le*Ci 



android:layout_toRightOf Puts the left edge of the view to the right of 

the view you're anchoring it to. 



^ — > CLICK ME 
Your view goes -fco ibe rijbi 
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Use margins to add distance between views 

When you use any of the layout attributes to position a view, the layout doesn’t 
leave much of a gap. You can increase the size of the gap between views by 
adding one or more margins to the view. 

As an example, suppose you wanted to put one view below another, but add 
50dp of extra space between the two. To do that, you’d add a margin of 50dp 
to the top of the bottom view: 

<RelativeLayout ... > 

<Button 

android : id=" @+id/button_click_me M 

... /> 



<Button 

android: layout_width="wrap_content" 

android : layout_height="wrap_content " 

android : layout_alignLef t=" @+id/button_click_me M 

android : layout_below=" @+id/button_click_me" 

android: layout_marginTop= M 5 Odp" ‘Adding 3 margin “to 



android : text=" 0 string /butt on_be low" / > 
</RelativeLayout> 



the *top of -the bottom 
button adds e%tra spade 
between tbe *two views. 



Here’s a list of the margins you can use to give your views extra space. Add 
the attribute to the view, and set its value to the size of margin you want: 

android: at tribute="10dp" 




Attribute 

android:layout_marginTop 

android:layout_marginBottom 

android:layout_marginLeft 

android:layout_marginRight 



What it does 

Adds extra space to the top of the view. 
Adds extra space to the bottom of the view. 

Adds extra space to the left of the view. 

Adds extra space to the right of the view. 
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the user interface 

RelativeLayout 

LinearLayout 

GridLayout 



Before we move on to our next type of layout, here’s a summary of 
how you create relative layouts. 



How you specify a relative layout 



You specify a relative layout using <RelativeLayout>. You must 
specify the layout width and height, but padding is optional: 

<RelativeLayout xmlns : android="http : / / schemas . android. com/ apk/ res/android" 
android : layout_width="match_parent " 
android : layout_height= n match_parent M 
android : paddingBottom=" 1 6dp" 
android : paddingLef t=" 1 6 dp" 
android : paddingRight=" 1 6dp" 
android : paddingTop=" 1 6dp" . . .> 

</RelativeLayout> 



You can position views relative to the layout of another view 



You specify where each view should be positioned by adding layout 
attributes to it. These attributes can position the view relative to the 
parent layout — for example, in the bottom right corner, or centered. 
You can also use attributes to position views relative to another view. 
You anchor one view to another using the view’s ID. 



You can add margins to views to increase the space around them 



When you use any of the layout attributes to position a view, the layout 
doesn’t leave much of a gap. You can increase the size of the gap 
between views by adding one or more margins to the view: 

android : layout_marginTop="5dp" 
android : layout_marginBottom=" 5dp" 
android : layout_marginLef t="5dp" 
android : layout_marginRight="5dp" 



So far we’ve just been working with the relative layout, but there’s 
another layout that’s commonly used too: the linear layout. Let’s 
take a closer look. 
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linear layout 



RelativeLayout 
LinearLayout 
GridLayout 

\v\ a single row or column 

A linear layout displays its views next to each other, either vertically or 
horizontally. If it’s vertically, the views are displayed in a single column. If it’s 
horizontally, the views are displayed in a single row. 



Imearlayout displays views 



How you define a linear layout 

You define a linear layout using the <LinearLayout> element like this: 



You use J 
<LinearLayout> 
•bo de-Pine a linear 
layout- 



<LinearLayout xmlns : android="http : / / schemas . android . com/ apk/ res /android" 
android : layout_width="match_parent" These av - c s a* *e attributes we 

android : layout_height="match_parent " used -Por our relative layout- 

android :orientation=" vertical" ' Display views vertically. 



</LinearLayout> 



The android: layout_width, android: layout_height and 
android: orientation attributes are mandatory. 

android: layout_width and android: layout_height specify the 
layout width and height, just as it does with the relative layout. You use the 
android : orientation attribute to specify which direction you want to 
arrange views in. 

You arrange views vertically using: 



android : orientation= "vertical " 

You arrange views horizontally using: 

android : or ientation= " hori zontal " 



A linear 

layout with - — ^ 
a vertical 
orientation. 



• V A Q 12:39 



To 

Message 



SEND 

The views are arranged 
in a single Column i-p the 
orientation is vertical 




A linear layout with a 
horizontal orientation- 

ir 



T A B 12:37 



To Message send 

The views are arranged in a single row 
i-P the orientation is horizontal- 
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the user interface 

A linear layout displays views in the 
order they appear in the layout XML 



RelativeLayout 

LinearLayout 

GridLayout 



When you define a linear layout, you add views to the layout in the 
order in which you want them to appear. So if you want a text view 
to appear above a button, you must define the text view first: 



<LinearLayout ... > 

CTextView ^ 

android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android: text="@string/textViewl" /> 

<Button 

android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android: text="@string/click_me" /> 

</ Linear Layout > 

With a linear layout, you only need to give your views IDs if 
you’re explicitly going to refer to them in your activity code. 

This is because the linear layout figures out where each view 
should be positioned based on the order in which they appear in 
the XML. Views don’t need to refer to other views in order to 
specify where they should be positioned. 

Just as with the relative layout, you can specify the width and 
height of any views using android : layout_width and 
android: layout_height. The code: 

android : layout_width="wrap_content" 

means that you want the view to be just wide enough for its 
content to fit inside it — for example, the text displayed on a 
button or in a text view. The code: 

android: layout_width="match_parent" 
means that you want the view to be as wide as the parent layout. 



|-f you define “the *te%*t view above *tbe 
button in tbe ><M L, tbe text vi tv will 




android: lay out_width and 
android: lay outheight are 
mandatory attributes lor alt 
views, no matter which layout 
you use. 

They can take the values 
wrap_content, match_parent, 
or a specific dimension value 
such as l6dp. 
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Let's change up a basic linear layout 

At first glance, a linear layout can seem basic and inflexible. After all, 
all it does is arrange views in a particular order. To give you more 
flexibility, you can tweak your layouts appearance using some more of 
its attributes. To show you how this works, we’re going to transform a 
basic linear layout. 

The layout is composed of two editable text fields and a button. To 
start with, these text fields are simply displayed vertically on the screen 
like this: 



RelativeLayout 

LinearLayout 

GridLayout 



Eadh view -takes up -the 
least possible amount of 
vertidal spade. 



To 

Message 



SEND 



We’re going to change the layout so that the button is 
displayed in the bottom-right corner of the layout, and one 
of the editable text fields takes up any remaining space. 



Message 

The Message editable te*t -field 
bas been given a lot more spade. 



Tbe Send button now 
appears at tbe bottom 
right o-P tbe sdreen. 







SEND I 


<1 


o 


□ 
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the user interface 

Here's the starting point for the linear layout 

The linear layout contains two editable text fields and a button. 

The button is labeled “Send”, and the editable text fields contain 
hint text values of “To” and “Message”. 

Hint text in an editable text field is text that’s displayed when 
the text field is empty. It’s used to give users a hint as to what 
sort of text they should enter. You define hint text using the 
android : hint attribute: 

CLinearLayout xmlns : android="http : / / schemas . android . com/ apk/ res/ android" 
xmlns : tools="http : / / schemas . android . com/ tools" 
android : layout_width="match_parent" 
android : layout_height="match_parent " 
android : paddingBottom=" 1 6dp" 
android : paddingLef t=" 1 6dp" 
android : paddingRight=" 1 6dp" 
android : paddingTop= " 1 6dp" 
android : or ientation=" vertical" 
tools : context=" . MainActivity" > 



RelativeLayout 

LinearLayout 

GridLayout 



The values of 
•these strings 
are defined in 
£trings.*nd as 
usual 




<EditText 

android 
android 
android 



<EditText 

android : 
android : 
android : 



' 



<Button 

android : 
android : 
android : 
</LinearLayout> 



The editable te%t f ields are as 
wide as -the parent layout- 

: layout_width="match_parent" 

: layout_height="wrap_content" 

: hint="@ string/ to" /> ^ android^hint displays a hint to the user as to 

what they should type in the editable text -field. 

layout_width="match_parent" 
layout_height="wrap_content " 
hint="@string/message" /> 



layout_width="wrap_content" 
layout_height="wrap_content " 
text="@string/send" /> 




Message 



SEND 



All of these views take up just as much vertical space in the 
layout as they need for their contents. So how do we make the 
Message text field taller? 
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putting on weight 



Make a view streeeeetch by adding weight 

All of the views in our basic layout take up just as much vertical 
space as they need for their content. What we actually want is to 
make the Message text field stretch to take up any vertical space in 
the layout that’s not being used by the other views. 




RelativeLayout 

LinearLayout 

GridLayout 



We warrl *to make -the 

Message 'f ield stve-Uh 

vevtidally so that ft -fills any 
spav-e spade in the layout- 








<1 o □ 



In order to do this, we need to allocate some weight to the Message 
text field. Allocating weight to a view is a way of telling it to stretch 
to take up extra space in the layout. 

You assign weight to a view using 

android : layout_weight="number " 

where number is some number greater than 0. 

When you allocate weight to a view, the layout first of all makes sure 
that each view has enough space for its content. It makes sure that 
each button has space for its text, each editable text field has space 
for its hint, and so on. Once it’s done that, the layout takes any extra 
space, and divides it proportionally between the views with a weight 
of 1 or greater. 
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Adding weight to one view 

We need the Message editable text field to take up any extra 
space in the layout. To do this, we’ll set its layout_weight 
attribute to 1 . As this is the only view in the layout with a weight 
value, this will make the text field stretch vertically to fill the 
remainder of the screen. Here’s the code: 




the user interface 

RelativeLayout 

LinearLayout 

GridLayout 



CLinearLayout ... > 



<EditText 

android: layout_width="match_parent " 
android : layout_height="wrap_content M 
android:hint="@string/to" /> 



This <£di-tTe*t> and the <ButW 
have no layout_weight attribute set- 

They'll "tab 4 w ? as ' room as ^ e, ' r 

eon-tent needs, but no move- 



This view is -the only 
ohe with any weight- 
It will expand to ~ 
■fill the spade thats 
not needed by any 
o-f the other views. 



<EditText 



android: layout_width="match_parent ' 

android: layout_height= M Odp M 

android : layout_weight= " 1 " 

android: hint=" 0 string/message " /> 



The height ot the view will be determined by 
■ the linear layout based on the layout_weight- 
Setting the layout_height to Ody is more 
e-ftidient than setting it to "wrap dontent” 



<Button 



android: layout_width= n wrap_content ” 
android : layout_height= M wrap_content M 
android: text= n @string/send M /> 

</ Linear Layout > 

Giving the message editable text field a weight of 1 means that it 
takes up all of the extra space that’s not used by the other views 
in the layout. This is because neither of the other two views have 
been allocated any weight in the layout XML. 



The Message view has a weight 
°*f I* A$ its -the only view with 
its weight attribute set, it 
expands to take up any extra 
vertical spade in the layout- 



1 * 


VA Q 12:42 


fro 





By de-fault, the Message 
hint text appears in the 
middle. We II deal with 
that next- 

Message 
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Adding weight to multiple views 

In this example, we only had one view with a weight attribute 
set. But what if we had more than one? 

Suppose we gave the To text field a weight of 1 , and the 
Message text field a weight of 2 like this: 

<LinearLayout ... > 




RelativeLayout 

LinearLayout 

GridLayout 



<EditText 

android : layout_width="match_parent M 

android: layout_height="Odp" 
android : layout_weight= M 1 " 

android: hint=" @string/to" /> 

<EditText 

android: layout_width= n match_parent" 

android: layout_height="Odp" 
android : layout_weight= M 2 " 

android: hint="@ string/message" /> 

</ Linear Layout > 



To figure out how much extra space each view takes up, start by 
adding together the layout_weight attributes for each view. 
In our case, this is 1+2=3. The amount of extra space taken 
up by each view will be the view’s weight divided by the total 
weight. The To view has a weight of 1 , so this means it will take 
up 1 / 3 of the remaining space in the layout. The Message view 
has a weight of 2, so it will take up 2/3 of the remaining space. 




1 80 Chapter 5 






Use gravity to specify 
where text appears in a view 

The next thing we need to do is move the hint text inside the 
Message text field. At the moment, it’s centered vertically 
inside the view. We need to change it so that the text appears 
at the top of the text field. We can achieve this using the 
android: gravity attribute. 

The android : gravity attribute lets you specify how you 
want to position the contents of a view inside the view — for 
example, how you want to position text inside a text field. If you 
want the text inside a view to appear at the top, the following 
code will do the trick: 

android : gravi ty= " top " 

We’ll add an android : gravity attribute to the Message text 
field so that the hint text moves to the top of the view: 

<LinearLayout ... > 

<EditText 

android : layout_width="match_parent " 



the user interface 

RelativeLayout 

LinearLayout 

GridLayout 



* Va Q 12:42 



W t need *to move “the 
Message hin*t *te*t 

-from the Center o-f 

the view to the top. 



SEND 



<1 O □ 



/t 



Message 




android: layout_height=" Odp" * 

android: layout_weight="l" Display Ihe te*t mside the le*l tield 

android: gravi ty=" top" ,C ^ 

android: hint=" 0 string/message" /> 



</ Linear Layout > 




Test drive 

Adding the android : gravity attribute to the Message text field 
moves the hint text to the top of the view, just like we want. 

You’ll find a list of the other values you can use with the 
android : gravity attribute on the next page. 
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gravity 



Using the android:gravity attribute: 
a list of values 

Here are some more of the values you can use with the 
android : gravity attribute. Add the attribute to your view, 
and set its value to one of the values below: 

android : gravity="value" 




RelativeLayout 

LinearLayout 

GridLayout 



Value 

top 

bottom 

left 

right 

center_vertical 

centerjtiorizontal 

center 

fill_vertical 

fill_horizontal 

fill 



What it does 

Puts the view's contents at the top of the view. 

Puts the view's contents at the bottom of the view. 
Puts the view's contents at the left of the view. 

Puts the view's contents at the right of the view. 
Centers the view's contents vertically. 

Centers the view's contents horizontally. 

Centers the view's contents vertically and horizontally. 
Make the view's contents fill the view vertically. 

Make the view's contents fill the view horizontally. 
Make the view's contents fill the view. 



android^ gravity lets you say wkere 
you want tke view’s contents to 
appear inside tke view. 
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Move the button to the right 
with layout.gravity 

There’s one final change we need to make to our layout. The Send 
button currently appears in the bottom-left corner. We need to move it 
over to the right so that it’s in the bottom-right corner instead. To do 
this, we’ll use the android: layout_gravity attribute. 

The android : layout_gravity attribute lets you specify where 
you want a view in a linear layout to appear in its enclosing space. You 
can use it to push a view to the right, for instance, or center the view 
horizontally. To move our button to the right, we’d need to add the 
following to the button: 

android : layout_gravity=" right" 




the user interface 
RelativeLayout 

LinearLayout 

GridLayout 




But why do we need 
to use layout_gravity to 
move the button? Earlier on 
we saw the layout_alignRight 
attribute— surely that would 
do it? 



The android:layout_alignRight attribute only 
applies to relative layouts. 

Layouts have some attributes in common, such as 
android: layout_width and android: layout_ 
height. Many attributes, however, are specific to one 
particular type of attribute. 

Most of the attributes we saw for the relative layout don’t 
apply to linear layouts. Linear layouts use the concept of 
gravity instead, so we have to use 

android: layout_gravity="right " 
if we want to move a view to the right. 

You’ll see a list of some of the other values you can use with 
the android: layout_gravity attribute on the next page. 
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More values you can use with the 
android.layout.gravity attribute 

Here are some of the values you can use with the 
android: layout_gravity attribute. Add the attribute to 
your view, and set its value to one of the values below: 

android : layout_gravity="value" 




RelativeLayout 

LinearLayout 

GridLayout 



Value 

top, bottom, left, right 
start, end 

center_vertical, center .horizontal 
center 

fill.vertical, fill.horizontal 
fill 



What it does 

Puts the view at the top, bottom, left, or right of its 
container. 

Puts the view at the start or end of its container. 



Centers the view vertically and horizontally in its 
container. 



Grow the view so that it fills its container in a vertical or 
horizontal direction. 



Grow the view so that it fills its container in a vertical 
and horizontal direction. 



Centers the view vertically or horizontally in its container. 



android- lay out gravity lets you say where you 
want views to appear in their available space. 

android- lay out_gravity deals with the placement 
ol the view itself, whereas android: gravity deals 
with how to display the view contents. 
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RelativeLayout 
LinearLayout 
GridLayout 

Here’s the full code for the linear layout: 



The full linear layout code 



<LinearLayout xmlns : android="http : / / schemas . android . com/ apk/ res/android" 
xmlns : tools="http : / / schemas . android . com/ tools" 
android : layout_width="match_parent " 
android : layout_height="match_parent " 
android : paddingBottom=" 1 6dp" 
android : paddingLef t=" 1 6dp" 
android : paddingRight=" 1 6dp" 
android : paddingTop=" 1 6dp" 
android : or ientation=" vertical" 
tools : context=" . MainActivity" > 



<EditText 

android : layout_width="match_parent" 
android : layout_height="wrap_content " 
android:hint="@string/to" /> 



<EditText 

android : layout_width="match_parent" 

android : layout_height=" Odp" 

android : layout_weight=" 1 " 

android : gravity="top" 

android : hint="@ string/message" /> 



<Button 

android : layout_width="wrap_content" 
android : layout_height="wrap_content " 



android : layou t_gravi ty= " right " 

android: text="@string/send" /> 



</LinearLayout> android^ravity is different to android:layout_ 
yavity. a^dv-oid^vavity relates to the 
Contents of the view, androidlayout^ravity 
relates to the view itself- 
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UnearUyout: a summary 

Here’s a summary of how you create linear layouts. 

How you specify a linear layout 

You specify a linear layout using <LinearLayout>. You must 
specify the layout width, height, and orientation, but padding is 
optional: 

CLinearLayout xmlns : android="http : / / schemas . android . com/ apk/ res/ android" 
android : layout_width="match_parent" 
android : layout_height="match_parent " 
android : or ientation=" vertical" 

. . . > 

</LinearLayout> 

Views get displayed in the order they appear 

When you define a linear layout, you add views to the layout in the 
order in which you want them to appear. 

Stretch views using weight 

By default, all views take up just as much space as necessary for their 
content. If you want to make one or more of your views take up more 
space, you can use the weight attribute to make it stretch: 

android : layout_weight=" 1 " 

Use gravity to specify where a view's contents appear in a view 

The android : gravity attribute lets you specify how you want to 
position the contents of a view inside the view — for example, how you 
want to position text inside a text field. 

Use layouhgravity to specify where a view appears in its enclosing space 

The android: layout_gravity attribute lets you specify where 
you want a view in a linear layout to appear in its enclosing space. You 
can use it to push a view to the right, for instance, or center the view 
horizontally. 



RelativeLayout 
^/\ LinearLayout 
GridLayout 



That’s everything we’ve covered on linear layouts. There’s one more 
view group we’re going to look at: the grid layout. 
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Here's the layout XML for the Beer Adviser app we created in 
Chapter 2. Change it to a linear layout that produces the output 
below. 



<RelativeLayout xmlns : android="http : / / schemas . android. com/ apk/ res/android" 
xmlns : tools="http : / / schemas . android . com/ tools" 
android : layout_width="match_parent" 
android : layout_height="match_parent " 
android : paddingBottom=" 1 6dp" 
android : paddingLef t=" 1 6dp" 
android : paddingRight=" 1 6dp" 
android : paddingTop=" 1 6dp" 
tools : context=" . FindBeerActivity" > 

<Spinner 

android: id="@+id/ color" 
android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android : layout_alignParentTop="true" 
android : layout_centerHorizontal="true" 
android : layout_marginTop="37dp" 
android: entries=" @array/beer_colors " /> 

<Button 

android : id=" @+id/ f ind_beer " 
android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android : layout_alignLef t=" @+id/ color" 
android : layout_below=" @+id/ color" 
android: text="0string/ f ind_beer" 
android: onClick="onClickFindBeer " /> 



<TextView 

android: id=" @+id/brands " 
android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android: layout_alignLef t=" @+id/ find_beer 
android: layout_below=" @+id/ find_beer" 
android : layout_marginTop=" 1 8dp" 
android: text="@string/brands" /> 
</RelativeLayout> 



M 



It won't win a«Y "“ost stylish layout" awards, but 
see i-f you dha«$e the ><ML to produd e this. 

£ 




sharpen solution 




Here's the layout XML for the Beer Adviser app we created in 
Chapter 2. Change it to a linear layout that produces the output 
below. 



Change it 
to a linear 
layout 



^<s&e-ta-td>veLinearLayout xmlns : android="http : / / schemas . android, com/ apk/ res/ android" 
xmlns : tools="http : / / schemas . android . com/ tools" 



android : layout_width="match_parent" 
android : layout_height="match_parent " 
android : paddingBottom=" 1 6dp" 

android : paddingLef t=" 16dp" Li near layouts use an android-orientation 

android :paddingRight="16dp" attribute- Use horizontal* to display views 

android :paddingTop="16dp" ne*t to ea£h other horizontally, 

android : orientation="horizontal " & 

tools : context=" . FindBeerActivity" > 



<Spinner 

android : id=" @+id/ color" 

android : layout_width="wrap_content" 

We don t need these lines. 



android: entries=" 0array/beer_colors " /> 



android : layout height="wrap content" 




<Button 

android : id=" @+id/ f ind_beer " 
android : layout_width="wrap_content" 
android : layout_height="wrap_content " 

^ don^t need these lines. 

android: text="@string/ f ind_beer" 
android: onClick="onClickFindBeer " /> 



<TextView 

android: id=" @+id/brands " 

android : layout_width="wrap_content" 

android : layout_height="wrap_content " 



Change it 
to a linear 
layout- 






^ Vk don't need these lines. 

$ dpr ™ 

android: text="@string/brands" /> 



</R@^ct ; HrveLinearLayout> 




(rridlayout displays views in a grid 




the user interface 

RelativeLayout 

LinearLayout 

GridLayout 



A grid layout splits the screen up into a grid of rows and columns, 
and allocates views to cells: 




Watch it! 



GridLayout 
requires 
API level 
14 or 
above. 



If you plan on using a 
grid layout, make sure 
your app uses a minimum 
SDK of AP1 14. 



You define a grid layout in a similar way to how you define the 
other types of layout, this time using the <GridLayout> element: 



r 



f <GridLayout xmlns : android="http : / / schemas . android. com/ apk/ res/android" 
android: layout_width="match_parent"^? These ave “the same attributes v it 

N ^ >u uSC android: layout_height="match_parent" J) uSC ^ ^ OV " ° UV " 

<6ridLavou't> , ^ 

android : columnCount= " 2 " S How *a*y CoU»s you wa»t your 

layout to have (i* this case, 1). 



here- 



</GridLayout> 



You specify how many columns you want the grid layout to have 
using: 

android: columnCount= M number" 



where number is the number of columns. You can also specify a 
maximum number of rows using: 

android: rowCount=" number" 

but in practice you can usually let Android figure this out based on 
the number of views in the layout. Android will include as many 
rows as is necessary to display the views. 
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grid layout 



Adding views to the grid layout 

You can add views to a grid layout in a similar way to 
how you add views to a linear layout: 

<GridLayout ... > 




RelativeLayout 

LinearLayout 

GridLayout 



<TextView 

android : lay out_width="wrap_con tent" 
android : layout_height= M wrap_content " 
android: text="@ string/ textview" /> 



<Button 

android : lay out_width= M wrap_con tent" 
android : layout_height="wrap_content " 
android: text="@string/click_me" /> 

<EditText 

android : lay out_width="wrap_con tent" 
android : layout_height="wrap_content " 
android :hint="@ string/edit" /> 



</ GridLayout> 



Just like a linear layout, there’s no need to give your 
views IDs unless you’re explicitly going to refer to 
them in your activity code. The views don’t need to 
refer to each other within the layout, so they don’t 
need to have IDs for this purpose. 

By default, the grid layout positions your views in the 
order in which they appear in the XML. So if you 
have a grid layout with two columns, the grid layout 
will put the first view in the first position, the second 
view in the second position, and so on. 

The downside of this approach is that if you remove 
one of your views from the layout, it can drastically 
change the appearance of the layout. To get around 
this, you specify where you want each view to appear, 
and how many columns you want it to span. 



* 



Q 13:13 



This is a text view CLICK ME 

f’lease type here 
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Let's create a new grid layout 

To see this in action, we’ll create a grid layout that specifies which 
cells we want views to appear in, and how many columns they 
should span. The layout is composed of a text view containing the 
text “To”, an editable text field that contains hint text of “Enter 
email address”, an editable text field that contains hint text of 
“Message”, and a button labeled “Send”: 




the user interface 

RelativeLayout 

LinearLayout 

GridLayout 



This is similar to -the example we used -4 
with the linear layout, except that 
there's how a To text -field at the 
top, ahd the Send button is Cehtered 
horizontally at the bottom. 







Here's what we're going to do 



o 



Sketch the user interface, and split it into rows and columns. 

This will make it easier for us to see how we should construct our layout. 



O 



Build up the layout row by row. 
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sketch it 



We'll start with a sketch 

The first thing we’ll do to create our new layout is sketch it out. That way 
we can see how many rows and columns we need, where each view should 
be positioned, and how many columns each view should span. 




RelativeLayout 

LinearLayout 

GridLayout 



1 st row 



2nd row- 



3rd row ■ 



1st 

column 



i 



2nd 

column 



4 



To 



Enter email address 



Message 



Send 



The first row has a text view in the 
^ first column with text of "To", and an 
editable text field in the 2nd column 
with a hint of "Enter email address". 



The second row has an editable text 
< ^ field with text of "Message". It starts 
in the first column and spans across the 
second. It needs to fill the available 
space. 






The third row has a button with text of 
"Send". It's centered horizontally across 
both columns, which means it needs to 
span the two columns. 



The grid layout needs two columns 



We can position our views how we want if we use a grid layout with two columns: 



<GridLayout xmlns : android= n http : / / schemas . android . com/ apk/ res/android M 
xmlns : tools= n http : / / schemas . android. com/ tools” 
android: layout_width=”match_parent” 
android: layout_height=”match_parent” 
android : paddingBottom=” 1 6dp” 
android : paddingLef t=” 1 6dp” 
android : paddingRight=” 1 6dp” 
android : paddingTop=” 1 6dp” 
android : columnCoun t= ” 2 ” 
tools : context=” . MainActivity” > 

</GridLayout> 



Now that we have the basic grid layout defined, we can start adding views. 
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the user interface 

Row 0: add views to specific rows and columns 



v/ RelativeLayout 
~ LinearLayout 
GridLayout 



The first row of the grid layout is composed of a text view in the 
first column, and an editable text field in the second column. You 
start by adding the views to the layout: 

<GridLayout. . . > 

CTextView 

android : layout_width="wrap_content " 
android : layout_height="wrap_content" 
android: text="@ string/ to" /> 

<EditText 





Enter email address 





You can use android: gravity 
and android: lay out_gravity 
attributes with grid layouts. 



android : layout_width="wrap_content " 
android : layout_height="wrap_content" 
android : layout_gravi ty=" f ill_horizontal " 
android : hint=" @ string/ to_hint" /> 

</ GridLayout> 



Vow can use layou-t_<yravi-ty m gvid layouts W 

— WeVe us'm^ -fill horizontal because we want 

tbe editable -text -field to -fill tbe remaining 
horizontal spade. 



Then you use the android : layout_row and android : layout_column 
attributes to say which row and column you want each view to appear in. The 
row and column indices start from 0, so if you want a view to appear in the first 
column and first row, you use: 



android : layout_row=" 0 " 
android: layout_column=" 




Columns and vows start at O, 
so this re-Pers to the -first vow 
and -first dolumn. 



Let’s apply this to our layout code by putting the text view in column 0, and the 
editable text field in column 1 . 



<GridLayout. . .> 
CTextView 



Row and column 
indices start at ©. 
layout_column=”n” 
refers to column 
n+1 in the display. 




android : layout_row= " 0 " 
android : layout_column= 

android : hint="@ string/ to_hint" /> 
</ GridLayout> 
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spanning columns 



Row 1: wake a view span multiple columns 

The second row of the grid layout is composed of an editable text 
field that starts in the first column and spans across the second. 

The view takes up all the available space. 






RelativeLayout 

LinearLayout 

GridLayout 



To get a view to span multiple columns, you start by specifying 
which row and column you want the view to start in. We want the 
view to start in the first column of the second row, so we need to 
use: 



android : layou t_row= " 1 " 
android : layout_column=" 0 " 

We want our view to go across two columns, and we can do this 
using the android: layout_columnSpan attribute like this: 

android : layout_columnSpan= "number" 

where number is the number of columns we want the view to 
span across. In our case, this is: 

android : layout_columnSpan=" 2 " 

Putting it all together, here’s the code for the Message view: 



Column 

0 

i 



Column 

1 

4 




<GridLayout. . .> 



<TextView. . 
<EditText . . 



/>^ 



/>' 



These are -the views we added on -the las-t page ( or vow O. 



<EditText 

android : layout_width="wrap_content " 
android : layout_height="wrap_content" 

android: layout_gravity=" fill" tVe wan*t “the view io -fill “the available spa£e> 
android :gravity=" top" ^ and (or the *te*t *to appear at “the “top. 

android : layou t_row=" 1 " 

android : layout column="0" • l / . i ^ 

- I he view starts in Column O, and spans Z 

android: layout_columnSpan=" 2" ^ Columns, 
android : hin t= " @ s tr ing/me s sage " /> 

</ GridLayout> 



Now that we’ve added the views for the first two rows, all we 
need to do is add the button. 
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the user interface 

Row l: wake a view span multiple columns 

We need the button to be centered horizontally across the 
two columns like this: 



y/ RelativeLayout 
~ LinearLayout 
GridLayout 



Column Column 

0 1 



A i 









Row 2 — > 






Send 











Column span = 2 




Layout Magnets 



We wrote some code to center the Send button in the third row of the grid layout, but a sudden 
breeze blew some of it away. See if you can reconstruct the code using the magnets below. 



<GridLayout. . . > 

<TextView. . . /> 

<EditText . . ./> "These are -the views we've already added- 

<EditText . . . /> 



<Button 

android : layout_width="wrap_content M 
android: layout_height="wrap_content M 

android: layout_row= 

android: layout_column= 

android: layout_gravity= 

android: layout_columnSpan= 

android: text="@string/send" /> 

</ GridLayout> 




[ center_horizontal 



Answers on page 224 
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layout code 

The full code for the grid layout 

<GridLayout xmlns : android= M http : / / schemas . android . com/ apk/ res/ android" 
xmlns : tools="http : / / schemas . android. com/ tools" 
android : layout_width="match_parent" 
android : layout_height="match_parent" 
android : paddingBottom=" 1 6dp" 
android : paddingLef t=" 1 6dp" 
android : paddingRight=" 1 6dp" 
android : paddingTop=" 1 6dp " 
android: columnCount="2 " 
tools : context=" . MainActivity" > 



RelativeLayout 
~ LinearLayout 

GridLayout 



<TextView 

android: layout_width="wrap_content" 
android : layout_height="wrap_content 
android : layout_row=" 0 " 
android : layout_column=" 0 " 
android: text=" @string/to" /> 

<EditText 

android : layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: layout_gravity=" f ill_horizontal" 
android : layout_row=" 0 " 
android : layout_column=" 1 " 
android: hint="@string/ to_hint" /> 



<EditText 

android : 
android : 
android : 
android : 
android : 
android : 
android : 
android: 

<Button 

android : 
android : 
android : 
android : 
android : 
android : 
android : 
</GridLayout> 



layout_width="wrap_content" 
layout_height="wrap_content" 
layout_gravity=" f ill" 
gravity="top" 
layout_row=" 1 " 
layout_column=" 0 " 
layout_columnSpan="2 " 
hint="@string/message" /> 



layout_width="wrap_content' 

1 ay ou t_he i gh t= " wr ap_con t en t " 
layout_row="2" 
layout_column=" 0 " 

layout_gravi ty= " cen ter_hor i zon tal " 
layout_columnSpan= " 2 " 
text="@ string/send" /> 




The button spans two 
Columns, s*tavtm^ 
-fvor* vow 2- dolumn 
I. Its den*teved 
hovizx>n*tallY* 
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(rridlayout: a summary 

Here’s a summary of how you create grid layouts. 

How you specify a grid layout 

You specify a grid layout using <GridLayout>. You specify how 
many columns you need using the android : columnCount 
attribute. You say how many rows you need using the 
android: rowCount attribute: 

<GridLayout xmlns : android="http : / / schemas . android. com/ apk/ res/ android" 
android : layout_width="match_parent " 
android: layout_height="match_parent" 
android: columnCount="2 " 

... > 



syj RelativeLayout 
~ LinearLayout 
d GridLayout 



</ GridLayout> 



Specify which row and column each view should start in 

You use the android : layout_row and android : layout_ 
column attributes to say which row and column you want each view 
to appear in. The row and column indices start from 0, so if you want 
a view to appear in the first column and first row, you use: 

android : layout_row=" 0 " 
android : layout_column=" 0 " 

Specify how many columns each view should span 

You use the android: layout_columnSpan attribute to specify 
how many columns each view should span. If you want a view to span 
across two columns, for instance, you use: 

android: layout_columnSpan="2 " 
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exercise 



BE 

Three of the five screens below were 
made from layouts on the opposite 
page. Your job is to match each of 
the three layouts to the 
screen that the layout 
would produce. 








o 
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<GridLayout xmlns : android="http : / / schemas . android. com/ apk/ res/android" 
xmlns : tools="http : / / schemas . android . com/ tools" 
android : layout_width="match_parent" 
android : layout_height="match_parent " 
android : columnCount="3" 
tools : context=" . MainActivity" > 

<Button 

android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android: layout_gravity=" f ill" 
android: layout_columnSpan="3" 
android: text="0string/helio" /> 

</ GridLayout> 



o 



<GridLayout xmlns : android="http : / / schemas . android. com/ apk/ res/android" 
xmlns : tools="http : / / schemas . android . com/ tools" 
android : layout_width="match_parent" 
android : layout_height="match_parent " 
android : columnCount="2 " 
tools : context=" .MainActivity" > 

<Button 

android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android: layout_gravity="f ill" 
android: layout_columnSpan="2 " 
android: text="0string/helio" /> 

<Button 

android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android: text="0string/hi" /> 

</ GridLayout> 



o 



<GridLayout xmlns : android="http : / / schemas . android . com/ apk/ res/ android" 
xmlns : tools="http : / / schemas . android . com/ tools" 
android : layout_width="match_parent" 
android : layout_height="match_parent " 
android : columnCount="2 " 
tools : context=" .MainActivity" > 

<Button 

android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android: layout_row=" 0 " 
android : layout_column=" 0 " 
android: layout_columnSpan="2 " 
android: text="0string/helio" /> 

<Button 

android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android: layout_row=" 1 " 
android : layout_column=" 0 " 
android: text="0string/hi" /> 

</ GridLayout> 
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solution 




BE th& Ify&t 

Three of the five screens below were 
made from layouts on the opposite 
page. Your job is to match each of 
the three layouts to the 
screen that the layout 
would produce. 



HELLO! 




Wone o-f the 
layouts produce 
these s£\reens. 



<1 



o 







<GridLayout xmlns : android= 

"http : / / schemas . android . com/ apk/ res/android" 
xmlns : tools="http : / / schemas . android . com/ tools" 
android : layout_width="match_parent" 
android : layout_height="match_parent " 
android : columnCount="3" 
tools : context=" . MainActivity" > 

<Button 

android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android: layout_gravity="f ill" __ 

android: layout_columnSpan=" 3" ,S as 

android: text="@string/hello" /> 

</ GridLayout> 



button that 
-f ills the sdveen- 



o 




© <GridLayout xmlns : android= 

"http : / / schemas . android . com/ apk/ res/ android" 
xmlns : tools="http : / / schemas . android. com/ tools" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: columnCount="2 " 
tools : context=" . MainActivity" > 

<Button 

android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: layout_gravity=" f ill " 

android : layout_columnSpan="2 " This button 

android : text=" @string/hello" /> -fills the screen, 

<Button leaving spade 

android: layout_width="wrap_content" -fov- another one 

android: layout_height="wrap_content" underneath it- 

android: text="@string/hi" /> 

</ GridLayout> 
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<1 O □ 



o 



<GridLayout xmlns : android= 

"http : / / schemas . android . com/ apk/ res/ android" 
xmlns : tools="http : / / schemas . android . com/ tools" 
android : layout_width="match_parent" 
android : layout_height="match_parent " 
android : columnCount="2 " 
tools : context=" . MainActivity" > 

<Button 

android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android : layout_row=" 0 " 
android : layout_column=" 0 " 
android: layout_columnSpan="2 " ^ 
android: text="@ string/hello" /> 

<Button 

android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android : layout_row=" 1 " 
android : layout_column=" 0 " 
android: text="@string/hi" /> 

</ GridLayout> 



Even *tbou$b 
•the button 
spans -two 
Columns, we 
didn t *tell it *to 
-Pill tbe sdv-een 
horizontally* 



Layouts and (rUI components have a lot in common 

You may have noticed that all layout types have attributes in 
common. Whichever type of layout you use, you must specify 
the layout width and height using the android : layout_ 
width and android: layout_height attributes. This 
isn’t just limited to layouts — the android : layout_width 
and android: layout_height are mandatory for all GUI 
components too. 

This is because all layouts and GUI components are 
subclasses of the Android View class. Let’s look at this in 
more detail. 
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views 



(rUI components are a type of View 



You’ve already seen that GUI components are all types of views — behind 
the scenes, they are all subclasses of the an droid. view. View 
class. This means that all of the GUI components you use in your user 
interface have attributes and behavior in common. They can all be 
displayed on the screen, for instance, and they can say how tall or wide 

they should be. Each of the GUI components you use in your user andv-oidUiev/Viev/ is *tbe base 

interface take this basic functionality, and extend it. dlass o£ all *tbe ^U| domponerrU 




Layouts are a type of View called a ViewGroup 

It’s not just the GUI components that are a type of view. Under the hood, 
a layout is a special type of view called a view group. All layouts are 
subclasses of the android . view . ViewGroup class. A view group is 
a type of view that can contain other views. 



A GUI component is a 
type ol view, an object 
which takes up space 
on the screen. 




A layout is a type of 
view group, which is 
a special type ol view 
that can contain other 
views. 
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What being a view buys you 

A View object occupies rectangular space on the screen. It includes 
the functionality all views need in order to lead a happy helpful life in 
Androidville. Here are some of the areas we think are the most important: 

(retting and setting properties 

Each view is a Java object behind the scenes, and that means you 
can get and set its properties in your activity code. As an example, 
you can retrieve the value selected in a spinner or change the text 
in a text view. The exact properties and methods you can access 
depend on the type of view. 

To help you with this, each view can have an ID associated with it 
so that you can refer to it in your code. 

Size and position 

You can specify the width and height of views so that Android 
knows how big they need to be. You can also say whether any 
padding is needed around the view. 

Once your view has been displayed, you can retrieve the position 
of the view, and its actual size on the screen. 

Focus handling 

Android handles how the focus moves depending on what the 
user does. This includes responding to any views that are hidden, 
removed, or made visible. 

Event handling and listeners 

Each of your views can respond to events. You can also create 
listeners so that you can react to things happening in the view. As 
an example, all views can react to getting or losing the focus, and 
a button (and all of its subclasses) can react to being clicked. 



Here are some o£ the l/iew 
methods you £an use in your 
activity eode. As these are in 
the base l/iew elass, theyre 
Common to all views and view 
groups. 

android.view.View 

getld() 

getHeightO 

getWidth() 

setVisibility(int) 

findViewByld(int) 

isClickableO 

isFocusedO 

requestFocusQ 




As a view group is also a type of view, this means that all layouts and GUI 
components share this common functionality. 
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view hierarchy 



A layout is really a hierarchy of Views 

The layout you define using XML gives you a hierachical tree of views and 
view groups. As an example, here’s a relative layout containing a button 
and an editable text field. The relative layout is a view group, and 
the button and text field are both views. The view group is the view’s 
parent, and the views are the view group’s children: 

<RelativeLayout xmlns : android="http : //schemas . android . com/apk/res/android" 




Behind the scenes, when you build your app, the layout XML is 
converted to a ViewGroup object containing a tree of Views. In the 
example above, the button gets translated to a Button object, and 
the text view gets translated to a TextView object. Button and 
TextView are both subclasses of View. 




This is the reason why you can manipulate the views in your layout 
using Java code. Behind the scenes, all of the views are rendered to Java 
View objects. 
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Playing with views 

Let’s look at the most common GUI components. You’ve already seen 
some of these, but we’ll review them anyway. We won’t show you the 
whole API for each of these — just selected highlights to get you started. 



Tcxtview 


This is a text view 1 


android.view.View 


Used for displaying text. 




1 


A 


defining it in XMl 










android. widget. TextView 



You define a text view in your layout using the <TextView> element. 
You use android : text to say what text you want it to display, usually 
by using a string resource: 



<TextView 

android : id=" @+id/ text_view M 
android: layout_width="wrap_content" 
android : layout_height="wrap_content " 
android: text="@string/text" /> 

The Text View API includes many attributes to control the text view’s 
appearance, such as the text size. To change the text size, you use the 
android: textSize attribute like this: 

android: textSize="14sp" 

You specify the text size using scale-independent pixels (sp). Scale- 
independent pixels take into account whether users want to use large 
fonts on their devices. A text size of 14sp will be physically larger on a 
device configured to use large fonts than on a device configured to use 
small fonts. 

Using it in your activity code 

You can change the text displayed in your text view using code like this: 

TextView textView = (TextView) f indViewByld (R. id. text_view) ; 
textView . setText ( "Some other string"); 
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editable text fields 




android : layout_height="wrap_content " 



android: hint="@ string/ edit_text" /> 



You can use the android : inputType attribute to define what type of 
data you’re expecting the user to enter so that Android can help them. As an 
example, if you’re expecting the user to enter numbers, you can use 

android: inputType="number " 



to provide them with a number keypad. Here are some more of our favorites: ewtive 

list m the online Andv-oid 



Value 

phone 

textPassword 

textCapSentences 

textAutoCorrect 



developer dodumen'td'tion. 



What it does 

Provides a phone number keypad. 

Displays a text entry keypad, and your input is concealed. 
Capitalizes the first word of a sentence. 

Automatically corrects the text being input. 



You can specify multiple input types using the | character. As an example, 
to capitalize the first word of a sentence and automatically correct any 
misspellings, you’d use: 

android: inputType="textCapSentences | textAutoCorrect" 



Using it in your activity code 

You can retrieve the text entered in an editable text view like this: 

EditText editText = (EditText) f indViewByld (R. id. edit_text) ; 
String text = editText . getText ( ) . toString ( ) ; 
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Putton 

Usually used to make your app do something when the 
button’s clicked. 



defining it in XMl 

You define a button in XML using the <Button> element. You use 
the android : text attribute to say what text you want the button to 
display: 

<Button 

android: id=" @+id/button n 
android: layout_width="wrap_content " 
android: layout_height="wrap_content" 
android: text="@string/button_text" /> 

Using it in your activity code 

You get the button to respond to the user clicking it by using the 
android: onClick attribute in the layout XML, and setting it to the 
name of the method you want to call in your activity code: 

android: onClick="onButtonClicked" 



CLICK ME 



You then define the method in your activity like this: 

/** Called when the button is clicked */ 
public void onButtonClicked (View view) { 

// Do something in response to button click 

} 




Layout 




Activity 



android.view.View 



A 



android. widget. TextView 



A 



android.widget.Button 
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toggle button 



Toggle button 

A toggle button allows you to choose between two states by clicking a button. 



This is whab "the 
■toggle button looks 
like when its o-P f . 

defining it in XMl 




When you dlidk 
the boggle 

button, it 
dhanges bo 
being on- 



You define a toggle button in XML using the <ToggleButton> element. 
You use the android: textOn and android: textOf f attributes to say 
what text you want the button to display depending on the state of the button: 

<ToggleButton 

android: id="0+id/ toggle_button" 
android: layout_width="wrap_content " 
android : layout_height="wrap_content" 
android: textOn=" @string/ on" 
android: textOf f=" @ string/off" /> 



Using it in your activity code 

You get the toggle button to respond to the user clicking it by using the 
android : onClick attribute in the layout XML. You give it the name of the 
method you want to call in your activity code: 

This is e*afrtly -the same 

android: onClick=" onToggleButtonCli eked" ^ — . as ta || m ^ a method when d 

normal button gets clidked 

You then define the method in your activity like this: 

/** Called when the toggle button is clicked */ 
public void onToggleClicked (View view) { 

// Get the state of the toggle button, 
boolean on = ( (ToggleButton) view) . isChecked ( ) ; 




if (on) { 
// On 
} else { 

// Off 



This returns true \( the boggle button is 
and -false i-P bhe boggle button is o£p. 



} 
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Switch 



A switch is a slider control that acts in the same way as a toggle button. 



This is -the sy/i-Uh 
when its o£p. 



■j _*jf 



This is "the 
sw'rtdh v/h en 

i*ts OY\- 



Pefining it in XML 

You define a toggle button in XML using the <Switch> element. You use 
the android: textOn and android: textOf f attributes to say what 
text you want the switch to display depending on the state of the switch: 



Watch it! 



A Switch 
requires API 
level 14 or 
above. 



If you want 
to use a switch in your 
app, make sure it uses a 
minimum SDK of API level 



14 . 



<Switch 

android: id="@+id/ switch_view M 
android: layout_width="wrap_content " 
android: layout_height="wrap_content" 
android : textOn=" @ string/ on" 
android: textOf f=" 0 string/off" /> 

Using it in your activity code 

You get the switch to respond to the user clicking it by using the 
android: onClick attribute in the layout XML, and setting it to the 
name of the method you want to call in your activity code: 

android : onClick="onSwitchClicked" 

You then define the method in your activity like this: 

/** Called when the switch is clicked */ 
public void onSwitchClicked (View view) { 

// Is the switch on? 

boolean on = ((Switch) view) . isChecked ( ) ; 

p 

This is vevy similar Code t> i\\ai 
used v/rlh *the *to^le button. 

} 



if (on) { 
// On 
} else { 

// Off 




} 
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Check boxes 

Check boxes let you display multiple options to users. They can then select 
whichever options they want. Each of the checkboxes can be checked or 
unchecked independently of any others. 




Wtrt we have -two dheekbox.es. 
Usevs dan dhoose milk, su^av, 
both milk and su^av, or neither- 



defining them in XML 

You define each checkbox in XML using the <CheckBox> element. You 
use the android : text attribute to display text for each option: 



<CheckBox android: id="0+id/ checkbox_milk M 
android : layout_width= n wrap_content" 
android : layout_height="wrap_content " 
android: text="@string/milk" /> 




<CheckBox android : id=" @+id/ checkbox_sugar " 
android : layout_width="wrap_content " 
android : layout_height="wrap_content M 
android: text="@string/ sugar" /> 

Using them in your activity code 

You can find whether a particular checkbox is checked using the 
is Che eked ( ) method. It returns true if the checkbox is checked: 



CheckBox checkbox = (CheckBox) f indViewByld (R. id . checkbox_milk) ; 
boolean checked = checkbox . isChecked () ; 
if (checked) { 

//do something 

} 
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Checkboxes (continued) 



Just like buttons, you can respond to the user clicking a checkbox by using 
the android : onClick attribute in the layout XML, and setting it to the 
name of the method you want to call in your activity code: 



<CheckBox android: id="0+id/ checkbox_milk" 
android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android: text="@string/milk M 



android : onClick= " onCheckboxClicked" / > 



<CheckBox android: id="0+id/ checkbox_sugar 
android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android: text="0string/ sugar" 

android: onClick=" onCheckboxClicked" /> 






lv\ -this case, -the o*Che£kbo*CkkedO 
me-thod will jet called matter 
wbieb dhedkbo* jets disked- We 
to\A& have spemied a di-P-Perent 
method -Por ea£h £he£kbo* i-P we ; d 
waited to- 



You then define the method in your activity like this: 

public void onCheckboxClicked (View view) { 

// Has the checkbox that was clicked been checked? 
boolean checked = ( (CheckBox) view) . isChecked ( ) ; 



// Retrieve which checkbox was clicked 
switch (view . getld () ) { 

case R . id . checkbox_milk : 
if (checked) 

// Milky coffee 

else 

// Black as the midnight sky on a moonless night 
break; 

case R . id . checkbox_sugar : 
if (checked) 

// Sweet 

else 

/ / Keep it bitter 
break; 

} 

} 
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Radio buttons 



These let you display multiple options to the user. The user can select a single 
option. 



,® Cavemen O Astronauts 



Use radio buttons to 
restrict the users dhoide 
to just one option- 



defining them in XML 



You start by defining a radio group, a special type of view group, using the 
<RadioGroup> tag. Within this, you then define individual radio buttons 
using the <RadioButton> tag: 



<RadioGroup android : id=" 0+id/ radio_group" 

android: layout width="match parent" ./ . , 

- - Yo u dan dhoose to 

android: layout_height="wrap_content" display the radio 

android: or ientation=" vertical "> ^ buttons in a horizontal 

or vertical list 

<RadioButton android: id="@+id/ radio_cavemen" 
android: layout_width="wrap_content " 
android: layout_height="wrap_content" 
android: text=" 0string/ cavemen" /> 



<RadioButton android: id="0+id/ radio_astronauts " 
android : layout_width="wrap_content " 
android: layout_height="wrap_content" 
android: text=" @string/ astronauts" /> 
</RadioGroup> 




Using them in your activity code 

You can find which radio button is selected using the 
getCheckedRadioButtonld ( ) method: 

RadioGroup radioGroup = (RadioGroup) f indViewByld (R. id. radioGroup) ; 
int id = radioGroup . getCheckedRadioButtonld () ; 

if (i d == -i) { 

//no item selected 

} 

else { 

RadioButton radioButton = f indViewByld (id) ; 

} 
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Radio buttons (continued) 

You can respond to the user clicking a radio button by using the 
android: onClick attribute in the layout XML, and setting it to the 
name of the method you want to call in your activity code: 

<RadioGroup android : id=" @+id/ radio_group" 
android: layout_width="match_parent " 
android : layout_height="wrap_content" 
android : orientation="vertical"> 

<RadioButton android: id="@+id/ radio_cavemen" 
android : layout_width="wrap_content " 
android: layout_height="wrap_content" 
android : text=" @ string/ cavemen" 

android: onClick="onRadioButtonClicked" /> 

<RadioButton android: id="@+id/ radio_astronauts " 
android: layout_width="wrap_content " 
android: layout_height="wrap_content" 
android: text=" Qstring/ astronauts" 

android: onClick="onRadioButtonClicked" /> 

</RadioGroup> 



The radio group 
containing the 
radio buttons 
is a subclass of 
LinearLayout. 
You can use the 
same attributes 



wi 



ith a radio 



group as you can 



wi 



ith a li 



near 



layout. 



You then define the method in your activity like this: 

public void onRadioButtonClicked (View view) { 

RadioGroup radioGroup = (RadioGroup) findViewByld (R . id . radioGroup) ; 
int id = radioGroup . getCheckedRadioButtonld () ; 
switch (id) { 

case R. id. radio_cavemen : 

/ / Cavemen win 
break; 

case R. id. radio_astronauts : 

/ / Astronauts win 
break; 

} 

} 
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Spinner 



As you’ve already seen, a spinner gives you a drop-down list of values 
from which only one can be selected. 

We saw spinneys ^ light 
ba£k in Cbap'tey Z . — ^1 



defining it in XMl 




You define a spinner in XML using the <Spinner> element. 

You add a static array of entries to the spinner by using the 
android : entries attribute and setting it to an array of strings. 



<Spinner 

android: id="@+id/ spinner" 

android : layout_width="wrap_content " 






Tbeve av-e otbev ways 
o£ populating tbe 
spinner, wbidb you II 
see later in tbe book. 



android: layout_height="wrap_content" 



android: entries=" @array/ spinner_values" /> 




You can add an array of strings to strings. xml like this: 

<st ring- array name="spinner_values"> 

<item>light</ item> 

<item>amber</ item> 

<item>brown</ item> 

<item>dark</ item> 

</ string-array> 

Using It in your activity code 

You can get the value of the currently selected item by using the 
getSelectedltem ( ) method and converting it to a String: 

Spinner spinner = (Spinner) findViewByld (R . id . spinner ) ; 

String string = String . valueOf (spinner . getSelectedltem ()); 
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Image views 



You use an image view to display an image: 



A* image view 
dorvlams an innate- 




Adding an image to your project 







The |mage\/iew dlass is a 
direct subdlass o£ \/iew. 



You first need to add an image file to your project as a drawable 
resource. If you expand the app/src /main/res folder in your project, 
you should see that there’s a folder called drawable. This is the default 
location for image resources. To add an image file to this folder, you 
simply drag the image file to it. 

You tveaie a new toldev by swibtbmj to 
-tbe Pvojett view ot your -Colder sWWe, 
Vi^btmj tbe res tolder, and tboosing 
Pile, New..., Android resourde diredtory. 



If you want, you can use different image files depending on the screen 
density of the device. This means you can display higher-resolution 
images on higher-density screens, and lower-resolution images on lower- 
density screens. To do this, you create different drawable folders in app / > « 
src/main/res for the different screen densities. The name of the folder 
relates to the screen density of the device: 



android-ldpi 

android-mdpi 

android-hdpi 

android-xhdpi 

android-xxhdpi 

android-xxxhdpi 



Low-density screens, around 120 dpi. 
Medium-density screens, around 1 60 dpi. 
High-density screens, around 240 dpi. 
Extra-high-density screens, around 320 dpi. 
Extra-extra-high-density screens, around 480 dpi. 



Depending on whai version o-p 
Android S-tudio youVe running, -the 
IDE may erea-te some of “these 
folders -for you au-fcoma-tieally. 



Extra-extra-extra high-density screens, around 640 
dpi. 

You then put different resolution images in each of the drawable* folders, 
making sure that each of the image files has the same name. Android 
decides which image to use at runtime, depending on the screen density 
of the device it’s running on. As an example, if the device has an extra 
high density screen, it will use the image located in the draw able- xhdpi 
folder. 



If an image is added to just one of the folders, Android will use the 
same image file for all devices. It’s common to use the drawable folder for 
this purpose. 
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Images: the layout XML 

You define an image view in XML using the <ImageView> element. 

You use the android : src attribute to specify what image you want to 
display You use the android: contentDescription attribute to 
add a string description of the image so that your app is more accessible: 

<ImageView 

android: layout_width="200dp" 
android: layout_height= n 100dp" 

android: src="@ drawable /starbuzz_logo" 

android: con ten tDe scrip tion= M @ string/ s tarbuzz_logo" /> 

The android: src attribute takes a value of the form " Qdrawable/ 
image_name", where image_name is the name of the image 
(without its extension). Image resources are prefixed with @drawable. 
@drawable tells Android that it’s an image resource located in one or 
more of the drawable folders. 

Using it in your activity code 

You can set the image source and description in your activity code using 
the setlmageResource ( ) and setContentDescription ( ) 
methods: 

ImageView photo = (ImageView) findViewByld (R. id. photo) ; 
int image = R. drawable . starbuzz_logo; 

String description = "This is the logo" ; 

photo . setlmageResource (image) ; 

photo . setContentDescription (description) ; 

This code looks for the image resource called starbuzz_logo in the 
drawable* folders, and sets it as the source of an image view with an ID 
of photo. When you need to refer to an image resource in your activity 
code, you use R . drawable . image_name where 
image_name is the name of the image (without its extension) 
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Adding images to buttons 



In addition to displaying images in image views, you can also display 
images on buttons. 



displaying text and an image on a button 

To display text on a button with an image to the right of it, use the 
android: drawableRight attribute and specify the image to be 
used: 



<Button 

android : layout_width="wrap_content " 
android: layout_height= n wrap_content" ^ 

android : drawableRight=" @drawable/android" 

android: text=" Qstring/ click_me" /> 

If you want to display the image on the left, use the 
android: drawableLeft attribute: 



Display the android Way resourde 
■the rio>ht side ot the button- 




<Button 

android: layout_width="wrap_content " 
android : layout_height="wrap_content" 

android : drawableLef t=" Qdrawable/android" 

android: text="@string/ click_me" /> 

Use the android: drawableBottom attribute to display the image 
underneath the text: 




<Button 

android: layout_width="wrap_content " 
android: layout_height="wrap_content" 

android : drawableBottom= M Qdrawable/android" 

android: text="@string/ click_me" /> 

The android: drawableBottom attribute displays the image above 
the text: 




<Button 

android : layout_width="wrap_content " 
android: layout_height="wrap_content" 

android : drawableTop=" Qdrawable/android" 

android: text=" Qstring/ click_me M /> 
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Image Button 

An image button is just like a button, except it contains an 
image and no text. 

it in XML 

You define an image button in XML using the <ImageButton> 
element. You use the android :src attribute to say what image you 
want the image button to display: 

<ImageButton 

android: id=" 0+id/button" 
android : layout_width="wrap_content " 
android: layout_height="wrap_content" 
android: src=" 0drawable/button_icon /> 

Using it in your activity code 

You get the image button to respond to the user clicking it by using the 
android: onClick attribute in the layout XML, and setting it to the 
name of the method you want to call in your activity code: 

android : onClick="onButtonClicked" 









The In.ayBwtU' tlass 
extends "the Ima^ey/iew elass, 
not -the Button tlass- Poes 
•that swv-pvise you? 



You then define the method in your activity like this: 

/** Called when the image button is clicked */ 
public void onButtonClicked (View view) { 

// Do something in response to button click 

} 




onButtonClicked() 

— 




Layout 



Activity 
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Scroll views 



If you add lots of views to your layouts, you may have problems on 
devices with smaller screens — most layouts don’t come with scrollbars 
to allow you to scroll down the page. As an example, when we added 
seven large buttons to a linear layout, we couldn’t see all of them. 



.a. 

2 

3 

. 0 . 



Linear layouts don't tome 
with strollbars. I/Vhen we 
tried to display seven 
buttons in a linear layout 
on our devite, we touldn t 
see them all* 



To add a vertical scrollbar to your layout, you surround your existing 
layout with a <ScrollView> element like this: 




<ScrollView xmlns : android= M http : //schemas . android. com/ apk/ res /android 
xmlns: tool s= M http: //schemas . android. com/ tools 

android: layout_width="match_parent " 
android : layout_height= n match_parent M 

tools : context= M . MainActivi ty " > 



III/ dpi 

/ 



/Wove these attributes to* the original 
layout to the <Sev-olH/iew> as the 
<£d<roll\/ie\w> is how the iroot eleihCht 



<Linear Layout 

android: layout_width="match_parent " 
android : layout_height="match_parent M 
android : paddingBottom=" 1 6dp" 
android : paddingLef t=" 1 6dp" 
android : paddingRight=" 1 6dp M 
android : paddingTop=" 1 6dp" 
android: orientation="vertical" > 

</ Linear Layout > 

</ScrollView> 

To add a horizontal scrollbar to your layout, wrap your existing 
layout inside a <HorizontalScrollView> element instead. 



'S' 

5 

& 

6 

& 



WVa'ppih^ ouv layout m a 
<£tvoll\/iew> has addled a «eat 
vertical sdvollbav The user ta» -'■'7 
now $et to all ot the views. 
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Toasts 

There’s one final widget we want to show you in this chapter: a 
toast. A toast is a simple pop-up message you can display on the 
screen. 

Toasts are purely informative, as the user can’t interact with them. 

While a toast is displayed, the activity stays visible and interactive. 

The toast automatically disappears when it times out. 

Using it in your activity code 

You create a toast using activity code only. You can't define one in 
your layout. 

To create a toast, you call the Toast . make Text ( ) method, and 
pass it three parameters: a Context (usually this for the current 
activity), a CharSequence that’s the message you want to display, 
and an int duration. Once you’ve created the toast, you call its 
show ( ) method to display it. 

Here’s the code you would use to create a toast that appears on 
screen for a short duration: 

CharSequence text = "Hello, I'm a Toast!"; 
int duration = Toast . LENGTH_SH0RT; 

Toast toast = Toast .makeText (this, text, duration); 
toast . show ( ) ; 




A Toast isn’t actually a 
type ot View- They ve a 
usetwl way o-f (yvin^ the 
wsev a short message, 
though, so we’ve sneaking it 
into this dhapter. 




By de-fault, the toast appears at 
the bottom o£ the sdreen- 



Hello, I'm a Toast! 
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It's time for you to try out some of the views we've introduced you to this chapter. Create a 
layout that will create this screen: 



You probably won't want *to write the 
Code t»e«, bot xby not enpcnWnt in tbe 
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ExefictSe 



Solution 



Here's one of the many ways in which you can create the layout. Don't worry if your code looks 
different, as there are many different solutions. 



c^jridLayout ^mlns.android^bttp*/ / sdbemas.androiddom/ apk/ res/ android” 



%mlns:tools:=*”bttp : / / sdbemas.androiddom/ -tools” 
android : layout__width— ”mat£h__parent” 
android:layout 3 c, 9 bt— ”matdb__parent” 

android : paddingBottorh==*”l bdp” 
android : paddingLe-f t—”! bdp” 
android : paddingRigbt— ”IMp” 
android^paddingTop— ”1 ^dp” 
android^olumnCount^Z” ^ 
tools:donte^t— ”-A1ainA^tivity” 



We used a <yrid layout, but 
yow could bave used a velatwe 
layout instead- 



We'll use two Columns. 



<7e*t\/iew 

android*layout_ width— ”wrap_dontent” 
android:|ayout_height-”wrap__£ontent” 

andvoid-layout :jro^"0’’ ^ p. |S?lay a ^ view at tbe to ? that sfans both Columns- 

android : layout_£olumn— 0 
android:layout_£olumn£pan— 2- 

android^te^t— ” ^string/ message” /> ^ All ot the views heed strings -to 

be added to strings.xml. 

<Te%t\/iew 

android : layout_width— ”wrap__£ontent” 
android : layout_height— ”wrap__£ontent” 

android : layout_jrow— ”1” Add a temperature label “to tbe 

android : layout_£olumn— ”0” Y\t*t row in 

android*te%t— ”$string/ temp” / > 



, tbe -first Column. 
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^ We used a -to^le butto* to display ***&*■ *** 

<To 9 3leBuiU *- should be sewed hot or told, a»d put it •» vow I, tolumr, 

android : layout_wid*tb= 1 >, y/v-ap - _dor\*tcr\*t W 

android : layout_beigbt— ’Wa^don-ten*^ 

android : layout__ro>/— w l }> 

android:layou*t_dolurnn— 'I w 

ar\dv-oid : tc%tOr\— W ^s*t\rih 5 /ho*t W 

android^e^O'f'P— ^s-bring/ to Id” / > 





Thanks for choosing our awesome blend tea. How do 
you want it serving? 

Temperature: HOT 



<CbedkBo% a*dv-oid:id— ’$+id/ dbedkbo%__rnilk^ 
ar\dv-oid : layou*t - _wid*tb= lW y/\rap - _dor\*tcr\'t W 
android : layoub_beigbb— W wrap — don-ten*^ 
andvoid-layoui_\row^ ,; Z ,; 
androi d : layoui_dol urm ti—'O” 
android : £e*£— ;; @s£ring/ milk” /> 

<CbedkBo% android^id— ; $+id/ dbedkbo*_sugar” 
ar\dv-oid : layou*t - _>wid'tb= lW y/v-ap - _dor\*tcr\'t W 
android : layoui_beigbt— ’Wa^don-teni” 
androi d : layou-t^jroy/—^ ”3 l> 
andv-oi d : layoui_dol um t^ n 0 n 
android : be%b—” (^string/ sugar” / > 

<ChetkBo* arvdroid : id— "@+id/ thetkbo*Je*v»oin" <r-' We used a thetkbox -for eatb o-f the 
android : layoub_widtb— ”wrap__ don*ten*t” values (Milk, Sugar, and Lemon). We 

andvoid:layout_bei 3 bt-"wv-ap_tonte»>t" pwt each °" e °* a ^ araie ^ 

androi d : layou£_row—^V 

androi d : layout^ol umn— W 0 W 
android : ie%i— ”$siring/lemon” / > 

</ £jridLayout> 
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yet another solution 






i 



Layout Magnets Solution 

We wrote some code to center the Send button in the third row of 
the grid layout, but a sudden breeze blew some of it away. See if you 
can reconstruct the code using the magnets below. 



<GridLayout. . . > 

<TextView. . . /> 
<EditText . . . /> 
<EditText . . . /> 




These are -the views we^ve already added- 



<Button 

android : layout_width="wrap_content " 
android : layout_height="wrap_content " 



android: layout_row= | "2" | ^ The button starts at row Z, dolumn O . 

IfVe want i o den-fcer ii hov-izon-fcally. 



android: layout_column= 



android : layout_gravity= I center__horizontal 



-.G 






] 



android: layout_columnSpan= 
android: text="@string/send" /> 
</ GridLayout> 



|t spans two dolumns. 



Column 

0 



Column 

1 









Row 2 — > 






Send 











Column span = 2 



% didn*t need to 
use these magnets- 
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Your Android Toolbox 

You’ve got Chapter 5 under 
your belt and now you’ve 
added views and view groups 
to your toolbox. 




BULLET POINTS 



■ GUI components are all types of 
view. They are all subclasses of the 

android . view . View class. 

■ All layouts are subclasses of the 
android . view . ViewGroup class. 
A view group is a type of view that can 
contain multiple views. 

■ The layout XML file gets converted to a 
ViewGroup containing a hierarchical tree 
of views. 

■ A relative layout displays child views 
relative to other views, or relative to the 
parent layout. 

■ A linear layout lists views either 
horizontally or vertically. You 
specify the direction using the 

android : orientation attribute. 

■ A grid layout divides the screen into a 
grid of cells so that you can specify which 
cell (or cells) each view should occupy. 
Use android : columnCount to 
say how many columns there should 

be. Use android: layout_row 
and android : layout_column 
to say which cell you want each view to 
appear in. Use android: layout_ 
columnSpan to say how many 
columns the view should spread across. 

■ Use android : padding* attributes 
to specify how much padding you want 
there to be around a view. 



Use android : layout_weight in 

a linear layout if you want a view to use up 
extra space in the layout. 

android : layout_gravity lets 
you say where you want views to appear 
in their available space. 

android : gravity lets you say 
where you want the contents to appear 
inside the view. 

<ToggleButton> defines a toggle 
button which allows you to choose 
between two states by clicking a button. 

<Switch> defines a switch control that 
behaves in the same way as a toggle 
button. It requires API level 14 or above. 

<checkBox> defines a checkbox. 

To define a group of radio buttons, 
first use <RadioGroup> to define 
the radio group. Then put individual 
radio buttons in the radio group using 

<RadioButton>. 

Use <ImageView> to display an 
image. 

<imageButton> defines a button with 
no text, just an image. 

Add scrollbars using <Scrollview> 
or <HorizontalScrollView>. 

A Toast is a pop-up message. 
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6 list Views and adapters 



^ Getting Organized * 




Want to know how best to structure your Android app? 

You’ve learned about some of the basic building blocks that are used to build apps, and 
now it’s time to get organized. In this chapter, we’ll show you how you can take a bunch 
of ideas and structure them into an awesome app. We ll show you how lists of data 
can form the core part of your app design, and how linking them together can create a 
powerful and easy-to-use app. Along the way, you’ll get your first glimpse of using event 
listeners and adapters to make your app more dynamic. 



this is a new chapter 
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ideas 



Every app starts with ideas 

When you first come up with an idea for an app, you’ll have 
lots of thoughts about what the app should contain. 

As an example, the guys at Starbuzz want a new app to 
entice more customers to their stores. These are some of the 
ideas they came up with for what the app should include: 



each 



detail 

dnoh. 






display a menu 
showing all -the 



•food 



you can 



\ 




shou) a list o^r aU 
our stores. 



Display a Us-t o^ 
-the drinhs roe 



sell. 



display -the 
address and 
openiny -times o-£ 
ea Ch store. 



L 



shorn detaWs o^ 
an hero o^ ^ood. 



Display a start 
screen uoith a 
list o^r options. 



These are all ideas that users of the app will find useful. 
But how do you take all of these ideas and organize them 
into an intuitive, well-organized app? 
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list views and adapters 



Categorize your ideas: 

top-level, category, and detail/edit activities 

A useful way to bring order to these ideas is to categorize 
them into three different types of activity: top-level 
activities, category activities, and detail/ edit activities. 



Top-level activities 

A top-level activity contains the things that are most 
important to the user, and gives them an easy way of 
navigating to them. In most apps, the first activity the 
user sees will be a top-level activity. 



Category activities 

Category activities show the data that belongs to a 
particular category, often in a list. These type of activities 
are often used to help the user navigate to detail/ edit 
activities. An example of a category activity is a list of all 
the drinks available at Starbuzz. 



Display 8 
s-tar-t screen 
u)i-th a lis-t 
op-tions. 



Shouo a list On- 
Display a \\ our stores. 

^ menu 

shouoiny all Display a lis-t 

-the ^o<5d uou ' t ' n6 

can buy. 3 toe s>e\\. 



Petail/edit activities 

Detail/ edit activities display details for a particular 
record, let the user edit the record, or allow the user to 
enter new records. An example of a detail/ edit activity 
would be an activity that shows the user the details of a 
particular drink. 

Once you’ve categorized your activities, you can use 
them to construct a hierarchy showing how the user will 
navigate between activities. 



s\nou) &.etav\s 
c£ an hero c& 
^ood. 



display -the 
address 
and openino 
-times o-? J 
each s-tore 




Think of an app you'd like to create. What activities should it include? Organize these activities 
into top-level activities, category activities, and detail/edit activities. 
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organize your ideas 



Navigating through the activities 

When you categorize the ideas you have into top-level, category, 
and detail/ edit activities, you can use these categorizations to 
figure out how to navigate through your app. In general, you 
want your users to navigate from top-level activities to detail/ 
edit activities via category activities. 



Top-level activities go at 
the top 

These are the activities your user 
will encounter first, so they go at 
the top. 



Display a 
start screen 
uoi-th a list o-S 
options. 



Category activities go 
between top-level and 
detail/edit activities 

Your users will navigate from the 
top-level activity to the category 
activities. In complex apps, you 
might have several layers of 
categories and subcategories. 

Petail/edit activities 

These form the bottom layer 
of the activity hierarchy. Users 
will navigate to these from the 
category activities. 



/ i \ 



Display a list 


Display 


shouo a list 0-S- 


oS- the drinbs 


a menu 


al \ our stores. 


uoe sell. 


shouoiny all 






-the Vx>d you 






can buy. 






Shouo de-tails 


Shouo de-tails 


Display -the 


o-S each 


o^ an i-tem o^r 


address 


dr mb. 


Vxxd 


and openiny 






-times o-S 






each store. 



As an example, suppose a user wanted to look at details of one 
of the drinks that Starbuzz serves. To do this, she would launch 
the app, and be presented with the top-level activity start screen 
showing her a list of options. The user would click on the option 
to display a list of drinks. To see details of a particular drink, she 
would then click on her drink of choice from the list. 
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Use ListViews to navigate to data 



When you structure your app in this way you need a way of navigating 
between your activities. A common approach used in this situation is to 
use list views. A list view allows you to display a list of data that you 
can then use to navigate through the app. 



As an example, on the previous page, we said we’d have a category 
activity that displays a list of the drinks sold by Starbuzz. Here’s what 
the activity might look like: 



TV»s is a ListView 

ton-taming a list ot drinks. 






Q 1C 




The activity uses a list view to display all the drinks that are sold by 
Starbuzz. To navigate to a particular drink, the user clicks on one of 
the drinks, and the details of that drink are displayed. 



I( you eliek on -the Latte 
option in the List\/iew, you 
gei shown -the details (or 
the Latte- 




Latte 

^ couple of espresso shots with steamed milk 



We’re going to spend the rest of this chapter showing you how to use 
list views to implement this approach using the Starbuzz app as an 
example. 
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welcome to starbuzz 



part of 

We're going to build the Starbuzz app 

Rather than build all the category and detail/ edit activities required 
for the entire Starbuzz app, we’re going to focus on just the 
drinks. We’re going to build a top-level activity that the user will 
see when they launch the app, a category activity that will display a 
list of drinks, and a detail/ edit activity that will display details of a 
single drink. 



The top-level activity 

When the user launches the app, she will 
be presented with the top-level activity, the 
main entry point of the app. This activity 
includes an image of the Starbuzz logo, and a 
navigational list containing entries for Drinks, 
Food, and Stores. 

When the user clicks on an item in the list, the 
app uses her selection to navigate to a separate 
activity. As an example, if the user clicks 
on Drinks, the app starts a category activity 
relating to drinks. 




iZZ 

Coffee 



Drinks 




The Starbuzz. I o<y>, and 
a list o-f options. We II 
implement the Prinks 
option. 



The drinks category activity 

This activity is launched when the user chooses 
Drinks from the navigational list in the top- 
level activity. The activity displays a list of all 
the drinks that are available at Starbuzz. The 
user can click on one of these drinks to see 
more details of it. 




■ 
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list views and adapters 



The drink detail activity 

The drink activity is launched when the user 
clicks on one of the drinks listed by the drink 
category activity 

This activity displays details of the drink the 
user has selected, such as its name, an image 
of what it looks like, and a desciption. 





^ Q 10:48 1 








How the user navigates through the app 

The user navigates from the top-level activity to the drink category 
activity by clicking on the “Drinks” item in the top-level activity She 
then navigates to the drink activity by clicking on a drink. 




Latte 

Cappuccino 

Filter 



When -the user 
dlidks on a drink, 
iha-t drink is -then 

displayed- 



Highest quality beans roasted and brewed fresh 



33r 
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app structure 



The Starbuzz app structure 

The app contains three activities. TopLevel Activity is the app’s 
top-level activity and allows the user to navigate through the app. 
DrinkCategoryActivity is a category activity; it contains a list of 
all the drinks. The third activity DrinkActivity, displays details of a 
given drink. 

For now, we’re going to hold the drink data in a Java class. In a later 
chapter, we’re going to move it into a database, but for now we want 
to focus on building the rest of the app without teaching you about 
databases too. 



o 

© 

© 



When the app gets launched, it starts activity TopLevelActivity. 

The activity uses layout activity _top_level.xml. The activity displays a list of 
options for Drinks, Food, and Stores. 



The user clicks on Drinks in TopLevelActivity. 

This launches activity DrinkCategoryActivity. This activity displays a 
list of drinks. 



Details of the drinks are held in the brink. java class file. 



DrinkCate$oryAdtivity 
doesn't need you to 
dreate a layout *for it- 
You'll see why later in 
the dhapter. 



DrinkCategoryActivity gets the values for its list of drinks from this 
class. 



Q The user clicks on a drink in DrinkCategoryActivity. 

This launches activity DrinkActivity. The activity uses layout activity _drink. 
xml. 



© 



DrinkActivity gets details of the drink from the brink. java class 
file. 



<Layou-t> I 
</Layou-fc> 



Why doesn't this 
activity_top_level.xml activity need a 



o 



Drink.java 




layout? You 'II -find 
out why later. 

° * 

TopLevelActivity.java DrinkCategoryActivity.java 





DrinkActivity.java 
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Here are the steps 

There are a number of steps we’ll go through to build the app: 



© 



Add the Drink class and image resources. 

The class contains details of the available drinks, 
and we’ll use images of the drinks and Starbuzz 
logo in the app. 




© 



Create TopLevel Activity and its layout. 

This is the entry point for the app. It needs to display 
the Starbuzz logo and include a navigational list of 
options. TopLevelActivity needs to launch 
DrinkCategoryActivity when the Drink option is clicked. 




•fC of ft* 

Food 



© 

© 



Create DrinkCategoryActivity. 

DrinkCategoryActivity contains a list of all the 
drinks that are available. When a drink is clicked, it needs 
to launch DrinkCategory. 



Create DrinkActivity and its layout. 

DrinkActivity displays details of the drink the 
user clicked on in DrinkCategoryActivity. 




Create the project 

You create the project for the app in exactly the same way you did 
for the previous chapters. 

Create a new Android project for an application named 
“Starbuzz” with a package name of com. hfad. starbuzz. The 
minimum SDK should be API 15. You’ll need an activity called 
“TopLevelActivity” and a layout called “activity_top_level”. 



Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 
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The Prink class 

We’ll start by adding the Drink class to the app. Drink.java is a pure Java class 
file that activities will get their drink data from. The class defines an array 
of three drinks, where each drink is composed of a name, description, and 
image resource ID. Add the class to the com.hfad.starbuzz package in the app / 
src/main/java folder in your project, giving it a class name of Drink. Then 
save your changes. 




Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 



These arc 

images o( 
the drinks. 

We II add 

these hext- 



package com.hfad. starbuzz ; 

Each Drink has a name, description, and image 

public class Drink { resource ID. The image resource ID refers to drink 

private String name; l ><ages we'll add to the project on the next page 

private String description; . ^ J 

private int imageResourceld; 

drinks is an array of three Drinks. 

//drinks is an array of Drinks ^ 
public static final Drink [] drinks = { 

new Drink ("Latte" , "A couple of espresso shots with steamed milk", 
* ^R.drawable . latte) , 



T 



new Drink ("Cappuccino" , "Espresso, hot milk, and a steamed milk foam", 
> R.drawable . cappuccino) , 

new Drink ("Filter" , "Highest quality beans roasted and brewed fresh", 
R . drawable . filter) 

1 The Drink £ons-iru£-fcor 



<r 



//Each Drink has a name, description, and an image resource 
private Drink (String name. String description, int imageResourceld) { 
this . name = name ; 
this . description = description; 
this . imageResourceld = imageResourceld; 

} 



public String getDescription () { 

return description; 

} 



□ 

Starbuzz 



public String getName() { 
return name; 

} 




These art getters (or -the 
private variables. 



4a3 

app/sre/main 

na 



java 



43 



com.hfad.starbuzz 

LQ 



public int getlmageResourceld () { 
return imageResourceld; 

} 



Drink.java 



public String toStringO ^ . . . 

return this . name ; ^ represent 



o( a Drink is i-ts name- 
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The image files 



The Drink code includes three image resources for its drinks with 
ids of R . drawable . latte, R . drawable . cappuccino 
and R. drawable .filter. These are so we can show the user 
images of the drinks. R . drawable .latte refers to an image 
file called latte , R . drawable . cappuccino refers to an image 
file called cappuccino , and R. drawable . filter refers to a file 
called filter. 

We need to add these image files to the project, along with an 
image of the Starbuzz logo so that we can use it in our top-level 
activity. To do this, download the files starbuzz- logo.png, cappuccino, 
png, filter. png , and latte.png from https://tinyurl.com/HeadFirstAndroid. 
Then drag the file to the app/src /main/res /drawable folder in your 
Starbuzz project. 

When you add images to your apps, you need to decide whether to 
display different images for different density screens. In our case, 
we’re going to use the same resolution image irrespective of screen 
density, so we’ve put a single copy of the images in one folder. If 
you decide to cater for different screen densities in your own apps, 
put images for the different screen densities in the appropriate 
drawable* folders as described in Chapter 5. 



Here are “the -four ima^e -files. You add 
•them to Android studio by drawing 
them to the drawable -folder. 



app 

d build 
d libs 
d sre 

► C androidTest 




When you save images to your project, Android assigns each 
of them an ID in the form R. drawable . image_name. As 
an example, the file latte.png is given an ID of R . drawable . 
latte, which matches the value of the latte’s image resource ID 
in the Drink class. 




name: "Latte" 



description: "A couple of expresso 
shots with steamed milk" 



imageResourceld: R. drawable. latte 



Drink 

Now that we’ve added the Drink class and image 
resources to the project, let’s work on the activities. We’ll 
start with the top-level activity. 



The ir*a$e latte 
is <yve* av\ IP o-f 
R.drawable.latte- 




R.drawable.latte 
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TopLevelActivity 



The top-level layout contains 
an image and a list 

When we created our project, we called our default activity 
TopLevelActivity.java, and its layout activity_top_level.xml. We need to 
change the layout so it displays an image and a list. 




Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 



This is -the S-fcavbuzz. logo. 

We added -this image to -the - 
project on -the previous page- 



A static list o-f options 




You saw how to display images in Chapter 5 using an image view. In 
this case, we need an image view that displays the Starbuzz logo, so 
we’ll create one that uses starbuzz^logo.png as its source. 

Here’s the code to define the image view in the layout: 



<ImageView 

'"'n • hese arc the dimensions y/e 

android: layout_width="200dp" ^ ^ have 

android: layout_height="100dp" ) The souvCe ot the image is the stavbuzr.Jogo.yng 

android: src=" @drawable/starbuzz_logo" ^ tile iwe added to the a'p'p- 

android: con ten tDe scrip tion="@ string/s tarbuzz_logo" Adding a Content description 

"'dkes your app more a££essible- 

When you use an image view in your app, you use the 
android: contentDescription attribute to add a description 
of the image; this makes your app more accessible. In our case, we’re 
using a string value of " @ string/ starbuz z_logo". Add this to Starbuzz 

strings, xml: 



<resources> 



413 

app/sre/main 



<string name="starbuzz_logo">Starbuzz logo</string> 

</ resources> 

That’s everything we need to add the image to the layout, so let’s 
move on to the list. 




values 




strings.xml 
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Use a list view to display the list of options 

As we said earlier, a list view allows you to display a vertical list of data 
that you can then use to navigate through the app. We’re going to add a 
list view to the layout that displays the list of options, and later on we’ll 
use it to navigate to a different activity 

How to define a list view in XML 

You add a list view to your layout using the <ListView> element. 

You then add an array of entries to the list view by using the 
android : entries attribute and setting it to an array of strings. The 
array of strings then gets displayed in the list view as a list of text views. 

Here’s how you add a list view to your layout that gets its values from an 
array of strings called options: 

<ListView = — -This defines the list view- 

android: id= M @+id/list_options M The values in 

android: layout_width= M match_j?arent M the list view are 

android: layout_height="wrap_content" defined by -the 

, . , „ . . Options avray. 

android: entries=" @array/ options " /> 1 




You define the array in exactly the same way that you did earlier in the 
book, by adding it to strings. xml like this: 

□ 

Starbuzz 



<resources> 



<string-array name=" options "> 
<item>Drinks</item> 

<i tem>Food</ i tem> 
<item>Stores</item> 
</string-array> 

</ resources> 



413 
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values 




strings.xml 



This populates the list view with three values: Drinks, Food, and Stores. 



@array/options 




ListView Food strings.xml 

Stores 



The en-bries attribute 
populates the Listl/iew with 
values -from the options array. 
Bath item in the Listl/iew is 
a Textl/iew- 
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The full top-level layout code 

Here’s our layout code in full (make sure you change your code 
to match ours): 




Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 



<LinearLayout xmlns : android="http : / / schemas . android. com/ apk/ res/android" 
xmlns : tools="http : / / schemas . android. com/ tools" 
android : layout_width="match_parent" 

android: layout_height="match_parent" WeVe usin^ a linear layout with a vertical 
android: orientation=" vertical" orientation- This will display our list view 

tools : context=" . TopLevelActivity" > directly underneath the Starbuzz. lo^o 



<ImageView 

android: layout_width="200dp" 
android: layout_height="100dp" 
android : src= " 0 dr awable/ s tarbuz z_logo " 

android: con ten tDescription="@ string/ starbuzz_logo" /> 
<ListView 

android: id="0+id/list_options" 
android : layout_width="match_j?arent " 
android : layout_height="wrap_content " 
android: entries="0array/options" /> 

</LinearLayout> 



□ 

Starbuzz 

HB 

app/src/main 

La 




activity_ 

topjevel.xml 




Test drive 



Make sure you’ve applied all the changes to activity _ top_ level. xml, 
and also updated strings. xml. When you run the app, you should 
see the Starbuzz logo displayed on the device screen with the 
list view underneath it. The list view displays the three values 
from the options array. 

If you click on any of the options in the list, nothing happens, 
as we haven’t told the list view to respond to clicks yet. The 
next thing we’ll do is see how you get list views to respond to 
clicks and launch a second activity. 




Starfewzz 
to Coffee 



Drinks^ 



Food 



Stores 



These are the values 
in the options array. 
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fret ListViews to respond to clicks with a Listener 



You make the items in a list view respond to clicks by 
implementing an event listener. 

An event listener allows you to listen for events that take 
place in your app, such as when views get clicked, when 
they receive or lose the focus, or when the user presses a 
hardware key on their device. By implementing an event 
listener, you can tell when your user performs a particular 
action — such as clicking on an item in a list view — and 
respond to it. 

OnltemClickListener listens for item clicks 



The List\/iew needs to know the 




The ListUiew -tells the Mtivity '"hen an item 
<^ets clicked so the Activity can v-eact- 



When you want to get items in a list view to respond to clicks, you 
need to create an OnltemClickListener and implement its 
onltemClick ( ) method. The OnltemClickListener listens 
for when items are clicked, and the onltemClick ( ) method 
lets you say how your activity should respond to the click. The 
onltemClick ( ) method includes several parameters that you can 
use to find out which item was clicked, such as a reference to the view 
item that was clicked, its position in the list view (starting at 0), and the 
row ID of the underlying data. 



We want to start DrinkCategoryActivity when the first 
item in the list view is clicked — the item at position 0. If the 
item at position 0 is clicked, we need to create an intent to start 
DrinkCategoryActivity. Here’s the code to create the listener: 



OnltemClickListener is 
a nested dass with -the 
Adapterl/iew dass. A List\/iew 
is a subclass o( Adapter\/iew. 



AdapterView. OnltemClickListener itemClickListener = new AdapterView. OnltemClickListener () { 



public void onltemClick (AdapterView<?> listView, ^ — 'The view that was disked (in this ease, 

View itemViewT^ the list view). 

Drinks is the -first item in the int os ition S 

list View, so it's at position O. in posi 10n ' ^These jive you more about whieh item was disked in the 
^ long id) { list view su£h as the item view and its position, 

if (position == 0) { 



} ; 



Intent intent = new Intent (TopLevel Activity. this , 

IK 

startActivity (intent) ; o 

The intent s doming Worn 

TopLevelA^tivity- 



DrinkCategoryActivity . class) 

It needs to launch 
DrinkCategoryActivity. 



Once you’ve created the listener, you need to add it to the ListView. 
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setOnltemClickListenerQ 



Set the listener to the list view 

Once you’ve created the OnClickltemListener, you need 
to attach it to the list view. You do this using the ListView 
setOnltemClickListener ( ) method. The method takes one 
argument, the listener itself: 




Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 



AdapterView . OnltemClickListener itemClickListener = new AdapterView . OnltemClickListener ( ) { 
public void onitemClick (AdapterView<?> listView, 



} 



} ; 



ListView listView = (ListView) findViewByld (R. id. list_options) ; 



listView. setOnltemClickListener (itemClickListener) 



K 



Adding the listener to the list view is crucial, as it’s this step that makes the 
listener get notified when the user clicks on items in the list view. If you 
don’t do this, the items in your list view won’t be able to respond to clicks. 



This is -the listener we jus* t treated- 



You’ve now seen everything you need in order to get the 
TopLevelActivity list view to respond to clicks. 



What happens when you run the code 



The onCreate() method in TopLevelActivity creates an 
OnltemClickListener and links it to the activity's ListView. 




TopLevelActivity ListView OnltemClickListener 



O 



When the user clicks on an item in the list view, the 
onltemClickListeners onItemClick() method gets called. 

If the Drinks item is clicked, the OnltemClickListener creates an intent to start 
DrinkCategoryActivity. 




ListView 



OnltemClickListener 



DrinkCategoryActivity 
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The full ToplevelActivity code 

Here’s the complete code for TopLevelActivity . j ava. 
Replace the code the wizard created for you with the code below, 
then save your changes: 

package com. hfad. starbuzz ; 



import android . app . Activity; 
import android . content . Intent; 
import android . os . Bundle ; 

import android . widget . AdapterView ; 
import android . widget . Lis tView ; 
import android. view. View; 



-Hv 



list views and adapters 

Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 




We've using these ex-tv a classes. 



public class TopLevelActivity extends Activity { 



□ 

Starbuzz 

Hn 

app/src/main 
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java_ 

M3 

com . hfad .starbuzz 

L @ 

TopLevel 

Activity.java 



Create t^e listener. 



@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_top_level ) ; 

//Create an OnltemClickListener ^ — 

AdapterView. OnltemClickListener itemClickListener = 

new AdapterView . OnltemClickListener ( ) { 
public void onltemClick (AdapterView<?> listView, 

View v, ^ 

int position, 
long id) { 

if (position == 0) { 

Intent intent = new Intent (TopLevel Activity . this , 

DrinkCategoryActivity . class) ; 



Implement its onltemCliCkO method- 



startActivity (intent) ; 



A 



} 



} 



} ; 



Launch pvinkCategovyActivity i-f the 
usev clicks on the pvinks item. We’ll 
Cveate this activity next, so don't u/ovvy 
i-f Andvoid studio says it doesn't exist 

//Add the listener to the list view 

ListView listView = (ListView) findViewByld (R. id. list_options) ; 
listView. setOnltemClickListener (itemClickListener) ; |.^ ^ ^ ^ 

lis-t view. 
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Where we've got to 

So far we’ve added Drink.java to our app and created 
TopLevelActivity and its layout. 



-Hv 



Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 



We’ve just fcvedted 
ToyL-evelAttivity activity_top_level.xml 
and its layout i 

? \ 

—O' 

Device TopLevelActivity.java 





We added bis -fivst 



4- 




DrinkCategoryActivity.java DnnkActivity.java 

We II dv-eate “tkis ne%t 



The next thing we need to do is create 
DrinkCategoryActivity so that it gets 
launched when the user clicks on the Drinks option in 
TopLevelActivity. 



tJiereicire no 

Dumb Questions 



% Why did we have to create an event listener to get items 
in the ListView to respond to clicks? Couldn't we have 
just used its android : onClick attribute in the layout 
code? 



You can only use the android: onClick attribute 
in activity layouts for buttons, or any views that are subclasses of 
Button such as CheckBoxes and RadioButtons. 

The ListView class isn’t a subclass of Button, so using 
the android: onClick attribute won’t work. That’s why you 
have to implement your own listener. 
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Here's some activity code from a separate project. When the user clicks on an item in a list 
view, the code is meant to display the text of that item in a text view. Does the code do what it’s 
meant to? If not, why not? The text view has an ID of text_view and the list view has an ID 

of list view. 



package com. hfad. ch 06 _ex; 



import android . app .Activity; 
import android . os . Bundle; 
import android . widget . AdapterView; 
import android . widget . ListView; 
import android . widget . TextView; 
import android . view .View; 

public class MainActivity extends Activity { 



QOverride 

protected void onCreate (Bundle savedlnstanceState ) { 

super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_main) ; 

final TextView textView = (TextView) f indViewByld (R . id . text_view) ; 
AdapterView . OnltemClickListener itemClickListener = 
new AdapterView . OnltemClickListener ( ) { 

public void onltemClick (AdapterView<?> listView, 

View v, 

int position, 

long id) { 

TextView item = (TextView) v; 
textView . setText ( item . getText ( ) ) ; 



} ; 

ListView listView 



(ListView) f indViewByld (R . id . list_view) ; 
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Excise 

^OLvtlPH 



Here's some activity code from a separate project. When the user clicks on an item in a list 
view, the code is meant to display the text of that item in a text view. Does the code do what it’s 
meant to? If not, why not? The text view has an ID of text_view and the list view has an ID 

of list view. 



package com. hfad. ch 06 _ex; 

import android. app .Activity; 
import android . os . Bundle ; 
import android . widget . AdapterView; 
import android . widget . ListView; 
import android . widget . TextView; 
import android . view .View; 

public class MainActivity extends Activity { 



QOverride 

protected void onCreate (Bundle savedlnstanceState ) { 

super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_main) ; 

final TextView textView = (TextView) f indViewByld (R . id . text_view) 
AdapterView . OnltemClickListener itemClickListener = 
new AdapterView . OnltemClickListener ( ) { 

public void onltemClick (AdapterView<?> listView, 

View v, 

int position. 

This is the item w the long id) { 

Listy/iew that was tlidked- • ^ TextView item = (TextView) v; 

\Vc a Teyt^icw, so we dan >. 

,x> , i-p i textView . setText ( item . getTextO); 



its te%t usin$ getTextO. 



} ; 

ListView listView = (ListView) f indViewByld (R . id . list_view) ; 

The dode doesn't work as intended as the line o-f Code 
list\/iey/.set()n|temClidkListenev(itemCli^kListenev-); 
is hissing -(rom the end P the dode. Apa^t -Pv-om that; the Codes -Pine- 
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A category activity displays the data 
for a single category 

As we said earlier, DrinkCategoryActivity is an example of 
a category activity. A category activity is one that shows the data 
that belongs to a particular category, often in a list. You then use 
the category activity to navigate to details of the data. 

We’re going to use DrinkCategoryActivity to display a list 
of drinks. When the user clicks on one of the drinks, we’ll show 
them the details of that drink. 




list views and adapters 

Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 




To do this, we’ll create an activity containing a single list view 
that displays a list of all the drinks. As our activity only needs to 
contain a single list view with no other GUI components, we can 
use a special kind of activity called a list activity. So what’s a list 
activity? 
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ListActivity 



A ListActivity is an activity 
that contains only a list 




Add resources 

TopLevelActivity 

DrinkCategoryActivity 

DrinkActivity 



A list activity is type of activity that specializes in working with a list. It’s 
automatically bound to a list view, so you don’t need to create one yourself. 
Here’s what one looks like: 



ListActivity is a 

subclass o-p Activity. 

ir 



A list activity domes 
Complete with its 
ov m list view so you s. 
<W t 1 r\tt& to add it 
youvsel-f • You still need 
to provide it with 
data, and you II see 
how to do that soon- 






android.app.Activity 


i 







android.app.ListActivity 

getListView() 
onListltemClickQ 



There are a couple of major advantages in using a list activity to display 
categories of data: 



o 



You don't need to create your own layout. 

List activities define their own layout programmatically, so 
there’s no XML layout for you to create or maintain. The 
layout the list activity generates includes a single list view. You 
access this list view in your activity code using the list activity’s 
getListView ( ) method. You need this to specify what data 
should be displayed in the list view. 



o 



You don't have to implement your own event listener. 

The ListActivity class already implements an event listener 
that listens for when items in the list view are clicked. Instead of 
creating your own event listener and binding it to the list view, you 
just need to implement the list activity’s onListl temClick ( ) 
method. This makes it easier to get your activity to respond when 
the user clicks on items in the list view. You’ll see this in action 
later on when we use the onListl temClick ( ) method to 
start another activity. 



Category activities generally need to display a single list view you can use 
to navigate to detail records, so list activities are good for this situation. 

So what does the list activity code look like? 



A ListActivity 
is a type ol 
Activity that 
specializes in 
working with 
a List View. It 
has a default 
layout that 
contains the 
ListView. 
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How to create a list activity 

Here’s what the basic code looks like to create a list activity. As you can see, it’s 
very similar to creating an activity Use the New Activity wizard to create a new 
activity in your project called DrinkCategoryActivity, then replace the 
contents of DrinkCategoryActivity.] av a with the code below: 



Android S-tudio may au-fcoma-tteally 
jenev-a-ie a layou-t -file (or you. I/Ve 
wem i use i-t because lis-t activities 
de-fine -their own layout 



package com.hfad. starbuzz ; 

import android. app . Lis tActivity; The activity needs -to extend 

import android, os . Bundle ; ListA^tivity> not ^tivity* 

public class DrinkCategoryActivity extends ListActivity { 



@ Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; f 

* ListAfitivrty inherits -the onCreateO 

Activity class. We'll add Code to this 



□ 

Starbuzz 

4 □ 

app/sre/main 



java_ 

LQ 

com.hfad. starbuzz 




DrinkCategory 

method -from the Activity.java 
method soon. 



The above code creates a basic list activity called 

DrinkCategoryActivity. Because it’s a list activity, it needs to extend 
the ListActivity class rather than Activity. 



The other difference is that you don’t need to use the setContentView() 
method to say what layout the list activity should use. This is because list 
activities define their own layouts so you don’t need to create one yourself. 

The list activity handles this for you. 

Just as with normal activities, list activities need to be registered in the 
AndroidManifest.xml file. This is so they can be used within your app. When you 
create your activity, Android Studio does this for you. 



Application 

... > 

Activity 

android : name=" . TopLevelActivity" 
android: label=" ©string/ app_name" 



- Heme's the tirst activity we Created- 

Heme’s the new activity- 

Every activity needs an (Vjj3 

entry in A«droid/V|ani-Cest-*m|. st ^dz 



</ activity> 

Activity 

android : name=" . DrinkCategoryActivity" 

android: label="@ string/ title_activity_drink_category" > 
</activity> 

</ application> 






app/sre/main 

|</ Xta|| 

AndroidManifest.xml 



Once you’ve created a list activity, you need to populate the list with data. 
Let’s see how. 
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android.entries works for static array 
data held in strings.xwl 

When we created our first activity Top Level Activity, we could 
bind data to the list view using the android: entries attribute in 
our layout XML. This worked because the data was held as a static 
string array resource. The array was described in strings. xml, so we 
could easily refer to it using 

android: entries="@array/ options" 




Add resources 

TopLevelActivity 

DrinkCategoryActivity 

DrinkActivity 



where options is the name of the string array. 

Using android: entries only works if the data is a static array 
in strings, xml. But what if it isn’t? What if the data is held in an array 
you’ve programmatically created in Java code, or held in a database? 

In this case, the android: entries attribute won’t work. 

If you need to bind your list view to data held in something other than 
a string array resource, you need to take a different approach; you need 
to write activity code to bind the data. In our case, we need to bind our 
list view to the drinks array in the Drink class. 



The list view needs 
to be populated 
with drinks data- 



The drink data 
needs to dome 
-Prom the drinks 
array in the 
Drink dlass. 




For nonstatic data, use an adapter 

If you need to display data in a list view that comes from a nonstatic 
source such as a Java array or database, you need to use an adapter. 
An adapter acts as a bridge between the data source and the list view: 



ListView 

> 





Well use an array 
^ — -for our data sourde, 
but we rwi^ht have 
used a database or 
a web servide- 



T 

The adapter bridges the $ap between the list 
view and the data sourde. Adapters allow list 
views to display data -from a variety ot soure.es. 



There are several different types of adapter. For now, we’re going to 
focus on array adapters. 
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An array adapter is a type of adapter that’s used to bind arrays to views. 
You can use it with any subclass of the Adapt erView class, which means 
you can use it with both list views and spinners. 

In our case, we’re going to use an array adapter to display data from the 
Drink, drinks array in the list view. 



Connect list views to arrays with an array adapter 

An adapter 
acts as a bridge 
between a View 
and a data 
source. An 
Array Adapter is 
a type ol adapter 
tbat specializes 
in working witb 
arrays. 



This is ouv lis-t view- 

V 



l/Vicll cveaie a* away adap-tev -to 

bind ouv - lis-t view -to ouV" away. This is ouv away* 

ir 'C' 



ListView 


Y 


^ 


Array 

^Adapter - 




Drink. 
_ drinks 




X 


/ 


7 





You use an array adapter by initializing the array adapter and attaching 
it to the list view. 



To initialize the array adapter, you first specify what type of data is 
contained in the array you want to bind to the list view. You then pass 
it three parameters: a Context (usually the current activity), a layout 
resource that specifies how to display each item in the array, and the 
array itself. 

Here’s the code to create an array adapter that displays Drink data 
from the Drink . drinks array: 






The away Coivtaifis Dvifik objects- 



ArrayAdapter<Drink> listAdapter = new ArrayAdapter<Drink> ( 

android . R . layout . simple_lis t_i tem_l , 

Dr ink. dr inks) ; The away 



-this is -the Cuwefit activity- 
The Activity class is a 
subclass o( Context. 



This is a built-in layout 
vesouvee- It tells the away 
adaptev to display each item in 
the away in a single text view. 



You then attach the array adapter to the list view using the ListView 
setAdapter ( ) method: 

ListView listView = getListView () ; 
listView. setAdapter (listAdapter) ; 



Behind the scenes, the array adapter takes each item in the array, 
converts it to a String using itstoStringO method and puts each 
result into a text view. It then displays each text view as a single row in 
the list view. 
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user an array adapter 



Add the array adapter to 
PrmkCategoryActivity 

We’ll change the DrinkCategoryActivity.java code so that the list view uses an 
array adapter to get drinks data from the Drink class. We’ll put the code 
in the onCreate () method so that the list view gets populated when the 
activity gets created. 

Here’s the full code for the activity (update your code to reflect ours, then 
save your changes): 




Add resources 

TopLevelActivity 

DrinkCategoryActivity 

DrinkActivity 



package com. hfad . starbuzz ; 



□ 

Starbuzz 



import android. app . ListActivity; 
import android. os . Bundle ; 

import android . widget . ArrayAdapter ; 

import android. widget . Lis tView; .„/ > h . , 

* We re usmj these e*t ra classes. 

public class DrinkCategoryActivity extends ListActivity { 



Hn 

app/sre/main 



java_ 

H2i 

com . hfad . starbuzz 




QOverride 

protected void onCreate (Bundle savedlnstanceState) 
super . onCreate (savedlnstanceState) ; 



DrinkCategory 

Activity.java 



ListView listDrinks = getListView () ; 



ArrayAdapter<Drink> listAdapter = new ArrayAdapter<Drink> ( 



this , 

android . R . layout . simple_lis t_item_l , 
Drink . drinks) ; 

listDrinks . setAdapter (listAdapter) ; 

} 






This populates the 
list view with data 
*fvom the drinks 

array. 



} 



These are all the changes that you need 
to get your list view to display a list of the 
drinks from the Drink class. 






Latte 



These are the drinks -from i - — 
the Drink drinks array. 



Cappuccino 
Filter 
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What happens when you run the code 



When the user clicks on the Drinks option, DrinkCategoryActivity is launched. 

As DrinkCategoryActivity is a list activity, it has a default layout containing a single 
ListView object. This layout is created behind the scenes in Java code, so it’s not defined by 
XML. 




DrinkCategoryActivity ViewGroup 



‘O 

ListView 



o 



DrinkCategoryActivity creates an ArrayAdapter<Drink>, an array adapter 
that deals with arrays of Drink objects. 




DrinkCategoryActivity ArrayAdapter<Drink> 



O 



The array adapter's source is the drinks array in the Drink class. 

It uses the Drink. toStringO method to return the name of each drink. 




DrinkCategoryActivity 




ArrayAdapter<Drink> 



Drink.drinks 



o 



DrinkCategoryActivity makes the ListView use the array adapter using the 
setAdapterO method. 

The list view uses it to display a list of the drink names. 




you are here ► 



253 



test drive 




Test drive the app 

When you run the app, TopLevelActivity gets 
displayed as before. When you click on the Drinks item, 
DrinkCategoryActivity is launched. It displays the names of 
all the drinks from the Dr ink Java class. 



Cli£k oy\ Pv'mks i'tcw' — ^ 
*to see d lis*t o-f dv-mks. 



StaHbuzz 

Coffee 



L 




App review: where we've got to 

So far we’ve added Drink.java to our app, and created activities 
TopLevelActivity and DrinkCategoryActivity. 



Device 



TopLevelActivity.java 



DrinkCategoryActivity.java 



activity_drink.xml 




The next thing we’ll do is get DrinkCategoryActivity to 
launch DrinkActivity, passing it details of which drink was 
clicked. 



DrinkActivity.java 

N T 

/M;, we'll get Dri«kCategov-yAdtivity 
to eal I Dv-inkAdtivity. 
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list views and adapters 



p(f)6>l plizzjc 

Your goal is to create an activity that binds 
a Java array of colors to a spinner. Take 
code snippets from the pool and place 
them into the blank lines in the activity. 
You may not use the same snippet 
more than once, and you won't need to 
use all the snippets. 



public class MainActivity extends Activity { 




String [] colors = new String [] {"Red", "Orange", "Yellow", "Green", "Blue"}; 



@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_main) ; 

Spinner spinner = ( ) findViewByld (R. id . spinner ) ; 

ArrayAdapter< > adapter = new ArrayAdapter< > ( 



android . R . layout . simple_spinner_item, 

colors) ; ^ 

TL 

spinner. (adapter) ; 



This displays ea£h value m -the away 
as a single vow m *the spirmev. 



Note: each thing from 




handling clicks 



How we handled clicks in T opLevel Activity 

Earlier on in the chapter, we needed to get TopLevelActivity to react 
to the user clicking items in the list view. To do that, we had to create an 
OnltemClickListener, implement its onltemClick ( ) method, and 
assign it to the list view: 

AdapterView. OnltemClickListener itemClickListener = new AdapterView. OnltemClickListener () { 
public void onltemClick (AdapterView<?> listView, ^ The list view 

The item view that was disked, its position in 
the list and the row ID ot the underlying data. 

//Do something when an item is clicked 

} 

} ; 

ListView listView = (ListView) findViewById(R. id. list_options) ; 

listView. setOnltemClickListener (itemClickListener) ; /\ dd | ^cy b> the list view. 



View itemView, 
int position, ^ > 
long id) { y 



sy Add resources 
V TopLevelActivity 

DrinkCategoryActivity 

DrinkActivity 



We had to set up an event listener in this way because list views aren’t 
hardwired to respond to clicks in the way that buttons are. 

So how should we get DrinkCategoryActivity to handle user clicks? 



listActivity implements an item click listener by default 

There’s a significant difference between TopLevelActivity and 
DrinkCategoryActivity. Whereas TopLevelActivity is 
a normal Activity object, DrinkCategoryActivity is a 
ListActivity, a special type of activity that’s designed to work with list 
views. 

This is significant when it comes to handling user clicks. A key difference 
between Activity and ListActivity is that the ListActivity 
class already implements an on item click event listener. Instead of creating your 

own event listener, when you use a list activity you just need to 
implement the onListltemClick ( ) method. 



public void onListltemClick (ListView listView, 

View itemView, 
int position, 
long id) { 

//Do something 



<< — These av-e -the same arguments that the 
onltemCkkO method above has: the list 
view* the item view that was elidked; its 
position in the list; and the row ID o( 
the underlying data. 



} 
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Pass data to an activity using the 
UstActivity onUstltemClicki) method 



When you use a list activity to display categories, you’ll 
usually use the onListl temClick ( ) method to start 
another activity that displays details of the item the user 
clicked. To do this, you create an intent that starts the second 
activity You then add the ID of the item that was clicked as 
extra information so that the second activity can use it when 
the activity starts. 

In our case, we want to start DrinkActivity and pass it 
the ID of the drink that was selected. DrinkActivity will 
then be able to use this information to display details of the 
right drink. Here’s the code: 



Intent 




DrinkCategoryActivity DrinkActivity 



public void onListltemClick (ListView listView, 



^^This gets tailed when an item's clicked- 



View itemView, 



pos t o , PrinkCatejoryAc-tivi-ty needs -to stavt 
long id) { Drinl^fetiviiy. ^ 

Intent intent = new Intent (DrinkCategoryActivity . this , DrinkActivity . class) ; 



intent . putExtra (DrinkActivity . EXTRA_DRINKNO , (int) id) 
startActivity (intent) ; 



r 



WeVe using a tons-fcan-t -for -the name o-P the 
e*t\ra in-formation in the intent so that we know 

DrinkCategoryActivity and DrinkActivity are 
using the same String. Well add the Constant to 
DrinkActivity when we Create the activity- 



Add the ID o-P the item that 
was clicked to the intent- 
This is the index- of the drink 
in the drinks array. 



It’s common practice to pass the ID of the item that was clicked as 
it’s the ID of the underlying data. If the underlying data is an array, 
the ID is the index of the item in the array. If the underlying data 
comes from a database, the ID is the ID of the record in the table. 
Passing the ID of the item in this way means that it’s easier for the 
second activity to get details of the data, and then display it. 

That’s everything we need to make DrinkCategoryActivity 
start DrinkActivity and tell it which drink was selected. The 
full activity code is on the next page. 
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DrinkCategoryActivity code 



The full PrinkCategory Activity code 

Here’s the full code for DrinkCategoryActivity.java (add the new 
method to your code, then save your changes): 



v 

-Hv 



Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 



package com. hfad. starbuzz ; 

import android . app . ListActivity; 
import android . os . Bundle; 
import android . widget . ArrayAdapter ; 
import android . widget . ListView; 

import android. view. View; ^ ^ ^ ^ese e *t*- a classes, 
import android . content . Intent ; 

public class DrinkCategoryActivity extends ListActivity { 



□ 

Starbuzz 

app/src/main 

HZ3 

java_ 

LQ 



com. hfad. starbuzz 




DrinkCategory 

Activity.java 



QOverride 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 

ListView listDrinks = getListView ( ) ; 

ArrayAdapter<Drink> listAdapter = new ArrayAdapter<Drink> ( 
this , 

android. R. layout . simple_list_item_l , 

Drink . drinks ) ; 

listDrinks . setAdapter (listAdapter) ; 



} 



@Override 

public void onListltemClick (ListView listView, 

View itemView, 



Uplcmchi ihc onLisiliernCkkO 
method so -tha-t DvmkA^tivi-ty is 
laughed when ihc user didks on an 
i'tcrw i n "the lis-fc view- 



int position, 
long id) { 

Intent intent = new Intent (DrinkCategoryActivity . this , DrinkActivity . classi- 
intent .putExtra (DrinkActivity .EXTRA_DRINKNO, (int) id); ^ 

startActivity (intent) ; ^ ad dil 5 prmkAA.vfy 

SO 



don't wovvy i-f A^dv'oid Studio 
says it doesn't e%ist- 
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A detail activity displays data 
for a single record 




list views and adapters 

Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 



As we said earlier, DrinkActivity is an example of a detail activity. A 
detail activity displays details for a particular record, and you generally 
navigate to it from a category activity 



We’re going to use DrinkActivity to display details of the drink the 
user selects. The Drink class includes the drink name, description, and 
image resource ID, so we’ll display this data in our layout. We’ll include 
an image view for the drink image resource, and text views for the drink 
name and description. 

Here’s our layout code. Add a new activity to your project called 
DrinkActivity with a layout called activity_drink, then replace 
the contents of activity _drink. xml with this: 



Make suve you tv-ea-be 
-the new activity. 



<LinearLayout xmlns : android= M http : //schemas . android. com/apk/res/android" 



xmlns : tools="http : / / schemas . android. com/ tools" 
android: layout_width="match_parent " 
android : layout_height="match_parent" 

android : orientation=" vertical " 

tools : context="com . hf ad . starbuzz . DrinkActivity" > 

<ImageView 

android: id="@ +id/pho to" 
android: layout_width="190dp" 
android: layout_height="190dp" /> 

CTextView 

android: id="@+id/name" 
android : layout_width="wrap_content " 
android: layout_height="wrap_content" /> 

CTextView 

android: id="@+id/ description" 
android : layout_width="match_j?arent " 
android: layout_height="wrap_content" /> 

< / LinearLayout> 

Once you’ve created the layout of your detail activity, we can 
populate its views. 



Starbuzz 



□ 

uzz 

413 

app/src/main 

HU 



MU 

layout 



|</ 

activity_drink.xml 
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get a drink 



Retrieve data from the intent 

As you’ve seen, when you get a category activity to start a detail 
activity, you get items in the category activity list view to respond 
to clicks. When an item is clicked, you create an intent to start the 
detail activity You pass the ID of the item the user clicked as extra 
information in the intent. 

When the detail activity is started, the detail activity can retrieve the 
extra information from the intent and use it to populate its views. 

In our case, we can use the information in the intent that started 
DrinkActivity to retrieve details of the drink the user clicked. 

When we created DrinkCategoryActivity, we added the ID 
of the drink the user clicked as extra information in the intent. We 
gave it a label of DrinkActivity . EXTRA_DRINKNO, which we 
need to define as a constant in DrinkActivity: 




Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 



public static final String EXTRA_DRINKNO = "drinkNo" ; 



As you saw in Chapter 3, you can retrieve the intent that started an 
activity using the get Intent ( ) method. If this intent has extra 
information, you can use the intent’s get* ( ) methods to retrieve it. 

Here’s the code to retrieve the value of EXTRA_DRINKNO from the 
intent that started DrinkActivity: 

int drinkNo = (Integer) getlntent (). getExtr as (). get (EXTRA_DRINKNO) ; 

Once you’ve retrieved the information from the intent, you can use 
it to get the data you need to display in your detail record. 

In our case, we can use drinkNo to get details of the drink the 
user selected. drinkNo is the ID of the drink, the index of the 
drink in the drinks array. This means that you can get the drink 
the user clicked on using: 

Drink drink = Drink . drinks [drinkNo] ; 



This gives us a Drink object containing all the information we 
need to update the views attributes in the activity: 



O 

drink 



name="Latte" 

description^ couple of espresso shots with steamed milk" 
imageResource!d=R.drawable.latte 
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Update the views with the data 

When you update the views in your detail activity, you need to make sure 
that the values they display reflect the data you’ve derived from the intent. 

Our detail activity contains two text views and an image view. We need to 
make sure that each of these is updated to reflect the details of the drink. 



O name 

description 

imageResourceld 

drink 




Drink Magnets 

See if you can use the magnets below to populate the 
DrinkActivity views with the correct data. 



//Get the drink from the intent 

int drinkNo = ( Integer ) getlntent (). getExtras (). get (EXTRA_DRINKNO) ; 
Drink drink = Drink. drinks [drinkNo] ; 



//Populate the drink image 

ImageView photo = (ImageView) findViewByld (R. id. photo) ; 



photo . 



(drink . getlmageResourceld ( ) ) ; 



photo . 



(drink . getName () ) ; 



//Populate the drink name 

TextView name = (TextView) findViewByld (R. id. name) ; 
name. (drink . getName ()) ; 



setText 



| setContentDescription j 



setContent 



se tlmageRe s ourceld 

//Populate the drink description 

TextView description = (TextView) findViewByld (R . id . description) ; 
description. (drink . getDescription () ) ; 

setText 




you are here ► 



261 



magnets solution 




Drink Magnets Solution 

See if you can use the magnets below to populate the 
DrinkActivity views with the correct data. 



//Get the drink from the intent 

int drinkNo = ( Integer ) getlntent (). getExtras (). get (EXTRA_DRINKNO) 
Drink drink = Drink. drinks [drinkNo] ; 



//Populate the drink image 

ImageView photo = (ImageView) findViewByld (R. id. photo) 



Y°* set the source 

o( -the imaae usinft I , _ — , 

setlmageResourdeO photo . | setlmageResource i( drink . getlmageResourceld ( ) 

This is needed 
to make the app 
more atdessible. 



photo 



. [ setContentDescription k (drink . getName () ) ; 



//Populate the drink name 

TextView name = (TextView) findViewByld (R. id . name) ; 



setText ^ (drink . getName ( ) ) ; 



Use setTextO to 




//Populate the drink description 



set the text in a 

text view V TextView description = (TextView) findViewByld (R . id . description) , 



description.) setText I (drink . getDescription ( ) ) ; 



You didn't need to use these 



f ,-1 



tlmageRe source I d~~[ 



setContent 
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The PrinkActivity code 

Here’s the code for DrinkActivity.java (replace the code the wizard 
gave you with the code below, then save your changes): 




list views and adapters 

Add resources 

TopLevelActivity 

DrinkCategoryActivity 

DrinkActivity 



package com. hfad. starbuzz ; 

import android . app . Activity ; 
import android . os . Bundle ; 
import android . widget . ImageView ; 
import android . widget . TextView ; 

public class DrinkActivity extends Activity { 



□ 

Starbuzz 

43 

app/src/main 

nr 3 

java_ 

43 



com. hfad. starbuzz 




public static final String EXTRA DRINKNO = "drinkNo" ; 

A' 

0 Override A dd £><TRA_PRI HMO as a Constant 

protected void onCreate (Bundle savedlnstance State) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_drink) ; 



DrinkActivity.java 



//Get the drink from the intent 

int drinkNo = (Integer) getlntent (). getExtras (). get (EXTRA_DRINKNO) ; 

Drink drink = Drink . drinks [drinkNo] ; ^ , . . . , 

Use the drinkNo to get details 

o-f the drink the user chose. 



//Populate the drink image 

ImageView photo = (ImageView) findViewByld (R. id. photo) ; 
photo . setlmageRe source (drink . getlmageResourceld ( ) ) ; 
photo . setContentDescription (drink . getName ( ) ) ; 



//Populate the drink name 

TextView name = (TextView) findViewByld (R. id. name 
name . setText (drink . getName ( ) ) ; 



Populate the views 
) ; with the dv-ink data* 



//Populate the drink description 

TextView description = (TextView) findViewByld (R. id. description) ; 
description . setText (drink . getDescription ( ) ) ; 



} 



you are here ► 



263 



what happens 



What happens when you run the app 




Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 



O 



When the user starts the app, it launches TopLevelActivity. 




Device 



O 



The onCreate() method in TopLevelActivity creates an 
onltemClickListener and links it to the activity's ListView. 



Q O^T) 

TopLevelActivity ListView onltemClickListener 



When the user clicks on an item in the list view, the 
onltemClickListener's onItemClick() method gets called. 

If the Drinks item was clicked, the onltemClickListener creates an intent to start 
DrinkCategoryActivity. 



o 




DrinkCategoryActivity is a List Activity. 

The DrinkCategoryActivity list view uses an ArrayAdapter<Drink> to display a 
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list views and adapters 



The story continues 



© 



When the user chooses a drink from the ListView, the onListItemClick() 
method gets called. 




ListView 



DrinkCategoryActivity 



Q) The DrinkCategoryActivity's onListItemClick() method creates an intent to 
start DrinkActivity, passing along the drink number as extra information. 



Intent 




drinkNo=0 



DrinkCategoryActivity 



DrinkActivity 



© 



DrinkActivity is launched. 

It retrieves the drink number from the intent, and gets details for the correct drink from the 
Drink class. It uses this information to update its views. 




DrinkActivity Drink 
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Test drive the app 



When you run the app, Top Level Activity gets 
displayed as before. 



• V A Q 10:26 



Coffee 



tVe ir*pler*eivted the Pv'mks 
pari the app. Ti ie othev 
iter*s wor/t do a^ythm^ i*f 
you dlidk oh them. 



When you click on the Drinks item, 
DrinkCategoryActivity is launched. It 
displays all the drinks from the Drink java class. 



When you click on one of the drinks, 
DrinkActivity is launched and details of the 
drink the user selected are displayed. 




_atte 

\ couple of espresso shots with steamed milk 




Using these three activities, you can see how to structure 
your app into top-level activities, category activities, and 
detail/ edit activities. Later on, we’ll revisit the Starbuzz 
app so that you can see how you can retrieve the drinks 
from a database. 
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list views and adapters 




Poo] puzz]e Solution 

Your goal is to create an activity that binds 
a Java array of colors to a spinner. Take 
code snippets from the pool and place 
them into the blank lines in the activity. 
You may not use the same snippet 
more than once, and you won't need to 
use all the snippets. 



public class MainActivity extends Activity { 

String [] colors = new String [] {"Red", "Orange", "Yellow", "Green", "Blue"}; 



@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_main) ; 

Spinner spinner 
ArrayAdapter< String > adapter = new ArrayAdapter< String > ( 
this , 



Wc re usihg ah array 

( Spinner ) findViewByld (R. id. spinner) ; ^ -fcypg Sjrih^. 



android. R. layout . simple_spinner_item, 
colors) ; 

spinner. setAdapter (adapter); 



Use setAdapterO to get the 
spihher to use the array adapter. 
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Your Android Toolbox 



You’ve got Chapter 6 under 
your belt and now you’ve 
added list views and app design 
to your toolbox. 



You ta* download 
iKe -full tode -fov- 
t he thaptev- -from 
tvbtys ://tinyu*-Uon>/ 
HeadPirstAndvoid- 




BULLET POINTS 



■ Sort your ideas for activities into top-level 
activities, category activities, and detail/ 
edit activities. Use the category activities to 
navigate from the top-level activities to the 
detail/edit activities. 

■ Image resources go in one or more of the 
drawable* folders. You reference them 

in your layout using Sdrawable/ 
image_name. You access them in your 
activity code using R . drawable . 
image_name. 

■ An imageview holds an image. Add it 
to your layout using <imageview>. Use 
android : src to set its source, and 

android : contentDescription 

to give it an accessible label. The 
equivalent methods in Java are 

setlmageResource ( ) and 
setContentDescription ( ) . 

■ A Listview displays items in a list. Add 
it to your layout using <Listview>. 

■ Use android : entries in your layout 
to populate the items in your list views from 
an array defined in strings.xml. 



A ListActivity is an Activity 

that comes with a Listview. You get 
a reference to the Listview using 
getListView ( ) . 

A ListActivity has its own default 
layout, but you can replace it with your 
own. 

An adapter acts as a bridge between an 
AdapterView and a data source. 

ListViewS and Spinners are both 
types of AdapterView. 

An ArrayAdapter is an adapter that 
works with arrays. 

Handle click events on Buttons using 
android : onClick in the layout code. 

Handle click events on a Listview in 
a ListActivity by implementing the 

onListltemClick ( ) method. 

Handle click events elsewhere by creating 
a listener and implementing its click event. 
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7 fragments 



^ Make it Modular + 




You’ve seen how to create apps that work in the same way 
irrespective of the device they’re running on. 

But what if you want your app to look and behave differently depending on whether it’s 
running on a phone or a tablet? In this chapter, we’ll show you how to make your app 
choose the most appropriate layout for the device screen size. We ll also introduce 
you to fragments, a way of creating modular code components that can be reused by 
different activities. 



this is a new chapter 
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different screen sizes 



Your app needs to look great on all devices 

One of the great things about Android development is that you 
can put the exact same app on devices with completely different 
screen sizes and processors, and have them run in exactly the 
same way But that doesn’t mean that they always have to look 
exactly the same. 



Oh a phone: 

Take a look at this image of an app on 
a phone. It displays a list of workouts, 
and when you click on one, you are 
shown the details of that workout. 

Clidk oy \ 3k rtem m 3 list* 3*d r ^ 
fb laundhes 3 second dfrtWi*ty* 




Oh a tablet: 

On a larger device, 
like a tablet, you have 
a lot more screen 
space available. It 
would be good if 
all the information 
appeared on the 
same screen. On 
the tablet, the list of 
workouts only goes 
part-way across the 
screen, and when 
you click on an item, 
the details appear on 
the right. 





C23 


cfzP 






To make the phone and tablet user interfaces look different from 
each other, we can use separate layouts for large devices and 
small devices. 
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fragments 



Your app may need to behave differently too 



It’s not enough to simply have different layouts for different devices. 
You also need different Java code to run alongside the layouts so that 
the app can behave differently depending on the device. In our 
Workout app, for instance, we need to provide one activity for 
tablets, and two activities for phones. 



On a phone: 



Here we have “two 
activities: or\t (or ** 
the list and one -for 
the details. 



The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 





On a tablet: 




Put that means you might duplicate code 

The second activity that runs only on phones will need to insert the 
details of a workout into the layout. But that code will also need to 
be available in the main activity for when the app is running on a 
tablet. The same code needs to be run by multiple activities. 

Rather than duplicate the code in the two activities, we can use 
fragments. So what’s a fragment? 
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fragments 



Fragments allow you to reuse code 

Fragments are like reusable components or subactivities. A 
fragment is used to control part of a screen, and can be reused 




A fragment has a layout 

Just like an activity, a fragment has an associated layout. If 
you design it carefully, the Java code can be used to control 
everything within the interface. If the fragment code contains 
all that you need to control its layout, it greatly increases the 
chances that you’ll be able to reuse it elsewhere in the app. 

We’re going to show you how to create and use fragments by 
building the Workout app. 
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fragments 



The Workout app structure 

For most of this chapter, we’re going to focus on building the version 
of the app that displays two fragments alongside each other in a 
single activity. Here’s a breakdown of how the app is structured, and 
what it does. 



o 

© 

© 

© 

© 



When the app gets launched, it starts activity MainActivity. 

The activity uses layout activity_main.xml. 

The activity uses two fragments, WorkoutListFragment, and 
WorkoutDetailFragment . 

WorkoutListFragment displays a list of workouts. 

It uses fragment_vuorkout_list.xml as its layout. 

WorkoutDetailFragment displays details of a workout. 

It uses fragment_workout_detail.xml as its layout. 

Both fragments get their workout data from Workout. java. 

Workout.java contains an array of Workouts. 




fragment_ 

workout_detail.xml 
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Here are the steps 



There are a number of steps we’ll go through to build the app: 



Create the fragments. 

We’ll create two fragments. WorkoutListFragment 
will be used to display a list of workouts, and 
WorkoutDetailFragment will be used to display 
details of a specific workout. We’ll display these 
fragments in a single activity. We’ll also add a plain old 
Java Workout class that the fragments will use to get 
their data from. 



Link the two fragments. 

When we click on a workout in 
WorkoutListFragment, we want 
to display details of the workout in 
WorkoutDetailFragment. 



The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 



The Limb Loosener 

5 Handstand push-ups 
10 1-legged squats 



The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 



The Wimp Special 

5 Pullups 
1 0 Pushups 
15 Squats 



Create device-specific layouts. 

Finally, we’re going to change our app 
so that it looks and behaves differently 
depending on what sort of device it’s 
run on. If it’s run on a device with 
a large screen, the fragments will be 
displayed alongside each other. If 
not, they’ll be displayed in separate 
activities. 



The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 



The Limb Loosener 



I The Limb Loosener 

Core Agony 

The Wimp Special 

Strength and Length 



The Wimp Special 

i Pull-ups 
0 Push-ups 
1 5 Squats 




Create the project 




You create the project for the app in exactly the same way you did for 
the previous chapters. 

Create a new Android project with a blank activity for an application 
named “Workout” with a package name of com . hf ad . workout. 
The minimum SDK should be at least API 1 7, as we’ll use this app in 
the next chapter to cover areas that require API 1 7 or above. You’ll 
need to specify an activity called “MainActivity” and a layout called 
“activity_main” so your code matches ours. 



Create fragments 
Link fragments 
Device layouts 
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The Workout class 

We’ll start by adding the Workout class to the app. 

Workout.java is a pure Java class file that the app will get workout data 
from. The class defines an array of four workouts, where each workout 
is composed of a name and description. Add the class to the com.hfad. 
workout package in the app/src/main/java folder in your project, giving 
it a class name of Workout. Then save your changes. 




fragments 

Create fragments 
Link fragments 
Device layouts 



package com . hf ad . workout ; 



public class Workout { 
private String name; 
private String description; 



Each Mforkout has a r,a»>c a*d desiv-ipW 

*/orkou-b is an av-vay ot touv l/Vovkouts. 



ir 



public static final Workout [] workouts = { 
new Workout ("The Limb Loosener", 

"5 Handstand push-ups\nlO 1-legged squats\nl5 Pull-ups") , 
new Workout ( "Core Agony", 

"100 Pull-ups\nl00 Push-ups\nl00 Sit-ups\nl00 Squats") , 
new Workout ("The Wimp Special", 

"5 Pull-ups\nlO Push-ups\nl5 Squats") , 
new Workout ( "Strength and Length", 

"500 meter run\n21 x 1.5 pood kettleball swing\n21 x pull-ups") 



} ; 



} 



//Each Workout has a name and description 
private Workout (String name. String description) 
this. name = name; 
this . description = description; 

} 



public String getDescription () 
return description; 

} 



{ 



public String getName() 
return name; 

} 



These are getters 
(or -the private 



variables. 



public String toStringO 
return this . name ; 

} 



The String 
representation o( 
B l/Vorkout is rts 
name. 



□ 

Workout 

4H 

app/src/main 

L a 

java_ 

LQ 

com.hfad. workout 




Workout.java 



The data will be used by the fragment WorkoutDetailFragment. 
We’ll create this fragment next. 
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How to add a fragment to your project 

We’re going to add a new fragment called WorkoutDetailFragment 
to the project to display details of a single workout. You add a new 
fragment in a similar way to how you add a new activity In Android 
Studio, go to File— >New..— ►Fragment— ► Fragment (Blank). 

You will be asked to choose options for your new fragment. Give the 
fragment a name of “WorkoutDetailFragment”, tick the option to create 
layout XML for it, and give the fragment layout a name of ^ swoflest looking at the e*t<ra Code 

“fragment_workout_detail”. Untick the options to include fragment ^ dvoid ftenev-ates -for you attev 

factory methods and interface callbacks; these options generate extra ou vc -f'misbed “this book. You mi^Vrb 

code which you don’t need to use. When you’re done, click on the Fin^T some. o-C i*t usc-ful depending oy\ 

button - Jkatylkaa to do. 



Create fragments 
Link fragments 
Device layouts 




When you click on the Finish button, Android Studio creates a new 
fragment file called WorkoutDetailFragment.java in the app/src/main/ 
java folder, and a new layout file called fragment_workout_detailxml in 
the app/src /res /layout folder. 
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fragments 



Fragment layout code looks just like 
activity layout code 

We’ll start by updating the layout code for the fragment. Open the 
file fragment_workout_detail.xml in the app/src /res /layout folder, and 
replace its contents with the code below: 



□ 

Workout 

413 

app/src/main 

HD 



<?xml version="1.0" encoding= M utf-8 M ?> 

<LinearLayout xmlns : android= M http : //schemas . android . com/ apk/res /android 
android : layout_height="match_j?arent " 
android : layout_width="match_j?arent" 
android: orientation=" vertical "> 



es _ 

HD 



layout 




fragment_ 
wo rko u t_d eta i I . xm I 



<TextView 

1/VeVe 
displaying 
-the v/ovkou*t 
name and 
description in 
two sepav-ate 
7e%t\/iews. 



android : lay out_width="wrap_con tent" 
android : layout_height="wrap_content " 

android: textAppearance="?android: attr/textAppearanceLarge" 
android : text=" " 



android: id="@+id/ textTi tie" /> — 



^CTextView 

android : lay out_width="wrap_con tent" 
android : layout_height="wrap_content " 
android : text=" " 

android : id=" @+id/ textDescription" /> 
</LinearLayout> 



As you can see, fragment layout code looks just like activity layout 
code. This is a very simple layout made up of two text views: a text 
view with large text to display the name of the workout, and a text 
view with smaller text to display the workout description. When you 
write your own fragment layout code, you can use any of the views 
and layouts you’ve already been using to write activity layout code. 



This is “the wovkouh name- 



This is -the 
wov-kou-t 
des£irip-tion. 



Core Agony 

100 Pull-ups 
,100 Push-ups 
1 00 Sit-ups 
100 Squats 



This is d 
•f*-a<ymen-t "tha-t 
vjc can use inside 
ouv- ac-tiviiies. 



Now that we’ve created a layout for our fragment to use, we’ll look at 
the fragment code itself. 
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fragment code 

What fragment code looks like 




Create fragments 
Link fragments 
Device layouts 



The code for the fragment is held in WorkoutDetailFragment.java in the app/ 
src/main/java folder. Open this file now. 

As you’d expect, Android Studio has generated Java code for you. Replace 
the code that Android Studio has generated with the code below: 



package com. hf ad. workout; 



□ 

Workout 



import android . app . Fragment ; 
import android . os . Bundle ; 
import android . view . Layoutlnf later ; 
import android . view . View ; 
import android . view . ViewGroup ; 



The dass extends *the 
/Mv-otd Fvajmovt class. 



app/src/main 

MB 

java 

LQ 

com . hfad .workout 



public class WorkoutDetailFragment extends Fragment { 

This is -the ohCreate\/iev/0 method- It's called 
@Override ^when Android needs the -Pva^ment^s layout- 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 




WorkoutDetail 

Fragment.java 



return inf later . inflate (R . layout . f ragmen t_workout_de tail , container , false) ; 



} 



} 



detail). 

The above code creates a basic fragment. As you can see, it’s a class 
that extends the android . app . Fragment class. All fragments 
must subclass the Fragment class. 

Our fragment also implements the onCreateView ( ) method. 

The onCreateView () method gets called each time Android 
needs the fragment’s layout, and it’s where you say which layout 
the fragment uses. This method is optional, but as you need to 
implement it whenever you’re creating a fragment with a layout, 
you’ll need to implement it almost every time you create a fragment. 

You specify the fragment’s layout using the code 



This -tells Android v/hidh layou-t -the -frajmen-t 
uses Cm -this ease, it's ^rajmen-tjworkoui 




Watch it! 



All fragments must 
have a public 
no-argument 
constructor. 



This is because Android 
uses it to reinstantiate the fragment 
when needed, and if it’s not there, 
you’ll get a runtime exception. 



inf later . inflate (R . layout . f ragmen t_workout_de tail , 
container, false) ; 

This is the fragment equivalent of an activity’s 
setContentView ( ) method. Just like setContentView ( ) , 
you use it to say what layout the fragment should use. The 
container argument is passed by the activity that uses the fragment. 
It’s the ViewGroup in the activity that the fragment layout needs 
to be inserted into. 



In practice, you only need to add 
one to your fragment code if you 
include another constructor with 
one or more arguments. This is 
because if a Java class contains 
no constructors, the Java compiler 
automatically adds a public no- 
argument constructor for you. 
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Adding a fragment to an activity's layout 

When we created our project, Android Studio created an activity for us 
called MainActivity.java , and a layout called activity _main. xml. We’re going to 
change the layout so that it contains the fragment we just created. 



□ 

Workout 

app/src/main 

HU 



To do this, open the activity _main. xml file in the app/src /main/res /layout folder, 
and replace the code Android Studio has given you with the code below: 




« ,, , activity main.xml 

<?xml version="l . 0" encoding= M utf-8 M ?> 

<LinearLayout xmlns : android="http : //schemas . android . com/ apk/res /android" 
android : orientation="horizontal " 
android : layout_width="match_j?arent" 
android : layout_height="match_j?arent"> 



<fragment 



class=" com. hf ad. workout . WorkoutDetailFragment" 
android: id="@+id/de tail_f rag" 
android : layout_width="match_j?arent" 
android: layout_height="match_j?arent" /> 
</LinearLayout> 

As you can see, the layout contains one element, <f ragmen t>. You 
use the <f ragmen t> element to add a fragment to an activity’s 
layout. You specify which fragment using the class attribute and 
setting it to the fully qualified name of the fragment. In our case, we’re 
going to create a fragment called WorkoutDetailFragment in the 
com . hf ad . workout package, so we use 

class= " com . hf ad . workout . WorkoutDetailFragment" 

We’ve created a fragment and got the activity to display it in its layout. 

So far, though, the fragment doesn’t actually do anything. What we 
need to do next is get the activity to say which workout to display, and 
get the fragment to populate its views with details of the workout. 



^-This adds the tra^ent 
W'ov-kowtPetailFv-ajn'ent to 
the activity's layout- 
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Create fragments 
Link fragments 
Device layouts 



Passing the workout IP to the fragment 

When you have an activity that uses a fragment, the activity will usually 
need to talk to it in some way As an example, if you have a fragment 
that displays detail records, you need the activity to tell the fragment 
which record to display details of 

In our case, we need WorkoutDetailFragment to display details of 
a particular workout. To do this, we’ll add a simple setter method to the 
fragment that sets the value of the workout ID. The activity will then 
be able to use this method to set the workout ID. Later on, we’ll use the 
workout ID to update the fragment’s views. 

Here’s the revised code for WorkoutDetailFragment (update your 
code with our changes): 




package com. hf ad. workout; 

import android. app . Fragment; 
import android. os . Bundle; 
import android . view . Layout Inf later ; 
import android. view. View; 
import android. view. ViewGroup; 



□ 

Workout 

app/src/main 

ma 



java_ 

com. hfad. workout 



public class WorkoutDetailFragment extends Fragment { 



private long workoutld; 



QOverride 



This is IP ot “the workout the user dhooses. 
La-tev, we'll use it to set the values Lament's 
views with the workout details- 




WorkoutDetail 

Fragment.java 



public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 

return inf later . inf late (R. layout . fragment_workout_detail, container, false); 

} 



public void setWorkout (long id) 
this .workoutld = id; 

} 



{ ^ This is a setter method tor the workout 
IP- The activity will use this method to 
set the value ©t the workout IP- 



The activity needs to call the fragment’s setWorkout ( ) method and 
pass it the ID of a particular workout. Let’s see how. 
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fret the activity to set the workout IP 



Before an activity can talk to its fragment, the activity first needs 
to get a reference to it. To get a reference to the fragment, you first 
get a reference to the activity’s fragment manager using the 
activity’s getFragmentManager ( ) method. You then use its 
f indFragmentByld ( ) method to get a reference to the fragment: 

getFragmentManager ( ) . f indFragmentByld (R . id . f ragmen t_i 



This is the IP ot the 
•fva^ment in the activity s 

if H=- 



The fragment manager is used to manage any fragments used by the 
activity. You use it to get references to fragments, and perform fragment 
transactions. You’ll see more about this later in the chapter. 

Here’s our full activity code (replace the existing code in MainActivity.java 
with the code shown here): 




'P'mdFraftmch-tByIdO is a 
bit like Find\/iewBy|dO 
except you use it to jet a 
re-Perende to a -(Vajment. 



package com. hf ad. workout; 

import android . app . Activity ; 
import android . os . Bundle ; 

public class MainActivity extends Activity { 

"LQ 

@ Override com. hfad. workout 

protected void onCreate (Bundle savedlnstanceState) { 

super . onCreate (savedlnstanceState) ; MainActivity.java 

setContentView (R . layout . activity_main) ; 

WorkoutDe tail Fragment frag = (WorkoutDetailFragment) 

getFragmentManager ( ) . f indFragmentByld (R . id . detail_f rag) ; 

frag. setWorkout (1 ) ; * , 

} V This jets us a v-e*rever>de to 

} I/Ve \re jomj to jet IA/b\rkoutDetailFvajme^t to display 1 /Vbv-koutPetailFv-ajrwe^t. Its id *m 

} details o-P a workout here to eheek it's workmj. the activity's layout is detail_Praj- 

As you can see, we’ve got a reference to the fragment after calling 
setContentView ( ) . This is really important, because before this, the 
fragment won’t have been created. 

We’re using the code frag . setWorkout ( 1 ) to tell the fragment 
which workout we want it to display details of. This is the custom method 
that we created in our fragment. For now, we’re just setting the ID of the 
workout in the activity’s onCreate () method so that we can see some 
data. Later on, we’ll change it so that the user can select which workout 
they want to see. 

The next thing we need to do is get the fragment to update its views when 
the fragment is displayed to the user. But before we can do this, we need 
to understand the fragment’s lifecycle. 




□ 

Workout 

H3 

app/sre/main 
1 ■ 



you are here ► 



281 



activity revision 



Activity states revisited 

Just like an activity, a fragment has a number of key lifecycle methods that 
get called at particular times. It’s important to know what these are and when 
they get called so your fragment works in just the way you want. 

Fragments are contained within and controlled by activities, so the fragment 
lifecycle is closely linked to the activity lifecycle. Here’s a reminder of the 
different states an activity goes through, and on the next page we’ll show you 
how these relate to the fragment. 




Create fragments 
Link fragments 
Device layouts 




Activity created 





Activity started 





Activity resumed 





Activity paused 





Activity stopped 





Activity destroyed 




The activity is created when its 
onCreate() method runs. 

At this point, the activity is initialized, 
but isn’t visible. 



The activity is started when its 
onStart() method runs. 

The activity is visible, but doesn’t have 
the focus. 



The activity is resumed when its 
onResume() method runs. 

The activity is visible, and has the focus. 



The activity is paused when its 
onPause() method runs. 

The activity is still visible, but no longer 
has the focus. 



The activity is stopped when its 
onStopO method runs. 

The activity is no longer visible, but still 
exists. 



The activity is destroyed when 
its onDestroyO method runs. 

The activity no longer exists. 
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The fragment lifecycle 

A fragment’s lifecycle is very similar to an activity’s, but it has a few 
extra steps. This is because it needs to interact with the lifecycle of 
the activity that contains it. Here are the fragment lifecycle methods, 
along with where they fit in with the different activity states. 



Activity states 


Fragment callbacks 


Activity created 


onAttach() 

i 




i 

onCreate() 




i 

onCreateView() 




i 

onActivityCreated() 

1 


Activity started 


I 

onStart() 

i 


Activity resumed 


I 

onResumeO 

i 


Activity paused 


I 

onPause() 

i 


Activity stopped 


i 

onStop() 

i 


Activity destroyed 


i 

onDestroyView() 

i 




i 

onDestroyO 




i 

onDetach() 



onAttach(Activity) 

This happens when the fragment is associated with an 
activity. 

onCreate(Bundle) 

This is very similar to the activity’s onCreate () method. 

It can be used to do the initial setup of the fragment. 

onCreateView(LayoutInflater # ViewGroup, Bundle) 

Fragments use a layout inflater to create their view at this 
stage. 

onActivityCreated(Bundle) 

This method is called when the onCreate () method of 
the activity has completed. 

onStart() 

The onStart ( ) method is called when the fragment is 
about to become visible. 

onResume() 

Galled when the fragment is visible and actively running. 

onPause() 

Galled when the fragment is no longer interacting with 
the user. 

onStopO 

Galled when the fragment is no longer visible to the user. 

onDestroyView() 

Gives the fragment the chance to clear away any 
resources that were associated with its view. 

onDestroyO 

In this method, the fragment can clear away any other 
resources it created. 

onDetach() 

When the fragment finally loses contact with the activity. 
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Your fragment inherits the lifecycle methods 

As you saw earlier, your fragment extends the Android 
fragment class. This class gives your fragment access to 
the fragment lifecycle methods. 




Create fragments 
Link fragments 
Device layouts 



Object 

5 

Fragment 

onAttach(Activity) 

onCreate(Bundle) 

onCreateView(Layoutlnflater, 
ViewGroup, Bundle) 

onActivityCreated(Bundle) 

onStartO 

onResumeO 

onPauseO 

onStopO 

onDestroyView() 

onDestroyO 

onDetach() 

getView() 

t 

YourFragment 

onCreateView(Layoutlnflater, 
ViewGroup, Bundle) 

yourMethodO 



Object class 

(java.Iang.Object) 



Fragment class 

(android.app.Fragment) 

The Fra^meiri ddss implemeirrfcs dc-Paul't versions 
ot the li-Pedydle methods. H also de-Pines other 
methods that -fragments need, sudh as getl/iewO. 



YourFragment class 

(com.hfad.foo) 

Mos* t of *the behavior of your -fra^e^'t is 
handled by superclass methods. AH y°* do is 
override the methods you need- 



Even though fragments have a lot in common with activities, the 
Fragment class doesn’t extend the Activity class. This means that 
some methods that are available to activities aren’t available to fragments. 

Note that the Fragment class doesn’t implement the Context class. 
Unlike an activity, a fragment isn’t a type of context and therefore doesn’t 
have direct access to global information about the application environment. 
Instead, fragments must access this information using the context of other 
objects such as its parent activity. 
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Set the view's values in the fragment's onStartO method 



We need to get Workout Detail Fragment to update its views with details 
of the workout. We need to do this when the activity is started, so we’ll use 
the fragment’s onStart ( ) method. Here’s the code: 



package com. hf ad . workout ; 



import android. app . Fragment; 

import android. os . Bundle; 

import android . view . Layout Inf later ; 

import android . view . View; 

import android. view. ViewGroup; . 

import android . widget . TextView ; 



tVeVe usinj “this dass in *the 
onS-tavtO method- 



public class WorkoutDetailFragment extends Fragment { 
private long workoutld; 



□ 

Workout 

lo 

app/src/main 

MB 

java_ 

4a 

com. hfad. workout 




WorkoutDetail 

Fragment.java 



@Override 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 

return inf later . inf late (R . layout . f ragment_workout_detail , container, false); 

} 



0 Override 

public void onStart () { t* e r»eihod gets the -fv-ag^emt's v-oot 

super .onStart () ; View- We then use this to jet v-e-Perenees to the 

View view = getView() ; ^ wovkout title and deseviption text vi ev/s. 
if (view != null) { 

TextView title = (TextView) view. findViewByld (R. id. textTitle) ; 

Workout workout = Workout .workouts [ (int) workoutld]; 
title . setText (workout . getName ( ) ) ; 

TextView description = (TextView) view. findViewByld (R. id. textDescription) 
description . setText (workout . getDescription ( ) ) ; 

} 



} 

public void setWorkout (long id) { 
this . workoutld = id; 



} 



} 

As we said on the previous page, fragments are distinct from activities, and 
therefore don’t have all the methods that an activity does. Fragments don’t 
include a findViewByld ( ) method, for instance. To get a reference to 
a fragment’s views, we first have to get a reference to the fragment’s root 
view using the get View ( ) method, and use that to find its child views. 

Now that we’ve got the fragment to update its views, let’s take the app for 
a test drive. 



You should always call 



up 



w 



to the superclass 
hen you implement 
any fragment lifecycle 
methods. 
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test drive the app 

When we run the app, details of a workout appear on the 
device screen. 

The app looks the same as if the workout details were 
displayed within an activity Because the activity is using a 
fragment to display details of the workout, we can reuse the 
fragment in another activity if we want to. 



-► 




Create fragments 






Link fragments 




— 


Device layouts 


* 




fi 1 08:03 


bore Agony 



100 Pull-ups 

1 oo Squats displayed m the -h-ajment- 



What happens when you run the app 




o 



o 



When the app is launched, activity MainActivity gets created. 




MainActivity passes the workout ID to WorkoutDetailFragment in its 
onCreateQ method by calling the fragment's setWorkoutQ method. 



© 




MainActivity 




WorkoutDetail 

Fragment 



The fragment uses the value of the workout ID in its onStart() method to 
set the values of its views. 




MainActivity 



A 



textTitle: CoreAgony 

textDescription: 100 Pull ups 
100 Push-ups 



WorkoutDetail 

Fragment 



100 Sit ups 
100 Squats 
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Where we've got to 

So far, we've created MainActivity.java , its layout activity _main. 
xml , the fragment WorkoutDetailFragment.java , its layout fragment_ 
workout_detail.xml , and the plain old Java class file Workout.java. 
MainActivity uses WorkoutListFragment to display 
details of the workout, and it gets the workout data from the 
Workout class. 




ac+ivity_main.xml 




fragment_ 

workou+_de+ail.xml 




MainActivity.java Fragment.java Workout.java 



The next thing we need to do is create the fragment 
WorkoutListFragment to display a list of the workouts. 

there] are no 

Dumb Questions 



Q Why can’t an activity get a fragment by calling the 
findViewById() method? 

Because f indViewByld ( ) always returns a View 
object and, surprisingly, fragments aren’t views. 

% Why isn’t findFragmentByld () an activity 
method like f indViewByld ( ) is? 

That’s a good question. Fragments weren’t available in early 
versions of Android. It uses the fragment manager as a way to add 
a whole bunch of useful code for managing fragments, without 
having to pack lots of extra code into the activity base class. 



Qk Why 
method? 



don’t fragments have a f indViewByld ( ) 



Because fragments aren’t views or activities. Instead, you 
need to use the fragment’s getview ( ) method to get a 
reference to the fragment’s root view, and then call the view’s 
f indViewByld ( ) method to get its child views. 



% Activities need to be registered in AndroidManifestxml so 
that the app can use them. Do fragments? 



No. Activities need to be registered in AndroidManifestxml, but 
fragments don’t. 
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Create fragments 
Link fragments 
Device layouts 



We need to create a fragment with a list 

Now that we’ve got WorkoutDetailFragment working, we need to 
create a second fragment that contains a list of the different workouts. 
We’ll then be able to use the fragments to create different user interfaces 
for phones and tablets. 





then update it with the names of the workouts. 




So the fragment will contain just a 
single list. I wonder... When we wanted 
to use an activity that contained a single 
list, we used a ListActivity. Is there 
something similar for fragments? 



He’s right. We can use a type of fragment 
called a ListFragment. 

We’ll look at this on the next page. 
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A ListFragment is a fragment 
that contains only a list 

A list fragment is a type of fragment that specializes in working with a list. 
Just like a list activity, it’s automatically bound to a list view, so you don’t 
need to create one yourself Here’s what one looks like: 



A list -(VayKent £or*es 
Complete with its own 
list view so you don t ^ 
need to add it yourself 
You just need to provide 
it with data. 



The Limb Loosener 



Core Agony 



The Wimp Special 



Strength and Length 



Just as with a list activity, there are are a couple of major advantages in 
using a list fragment to display categories of data: 



o 



You don't need to create your own layout. 

List fragments define their own layout programmatically, so 
there’s no XML layout for you to create or maintain. The 
layout the list fragment generates includes a single list view. You 
access this list view in your activity code using the list fragment’s 
getListView ( ) method. You need this in order to specify what 
data should be displayed in the list view. 



o 



You don't have to implement your own event listener 

The Li st Fragment class is registered as a listener on the list 
view, and listens for when items in the list view are clicked. You 
use the list fragment’s onListltemClick ( ) method to get 
fragment to respond to clicks. You’ll see this in action later on. 



So what does the list fragment code look like? 



Lis-tFvagmcht is a 
subclass o-p FlraAmCht 

ir 




A List Fragment 
is a type of 
Fragment that 
specializes in 
working with a 
List View. It has 
a default layout 
that contains the 
ListView. 
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How to create a list fragment 

You add a list fragment to your project in the same way you add a 
normal fragment. Go to File— >New..— ^Fragment— ^Fragment (Blank). 
Give the fragment a name of “WorkoutListFragment”, and then untick 
the options to create layout XML, and also the options to include 
fragment factory methods and interface callbacks. List fragments 
define their own layouts programmatically, so you don’t need Android 
Studio to create one for you. When you click on the Finish button, 
Android Studio creates a new list fragment for you in a file called 
WorkoutListFragment.java in the app/src/main/java folder. 

Here’s what the basic code looks like to create a list fragment. As you 
can see, it’s very similar to that of a normal fragment. Replace the code 
in WorkoutListFragment with the code below: 




Create fragments 
Link fragments 
Device layouts 



package com . hf ad . workout ; 

import android . os . Bundle ; 
import android . app . ListFragment ; 
import android . view . Layoutlnf later ; 

import android . view . View ; The a ^ivity *eeds U e*le«d 

import android. view. ViewGroup; UniFra^cnl, koI Fragment 

V 

public class WorkoutListFragment extends ListFragment { 



□ 

Workout 

4U 

app/src/main 

MB 



java_ 

com. hfad. workout 




@ Override 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 

return super .onCreateView (inf later , container, savedlnstanceState) ; 



WorkoutList 

Fragment.java 



} 

} 

The above code creates a basic list fragment called 
WorkoutListFragment. As it’s a list fragment, it needs to extend 
the ListFragment class rather than Fragment. 



Calling -the superclass onCreaiel/iev/O 
method jives you the de-fault layout 
-f or the Listrvajment- 



The onCreateView ( ) method is optional. The onCreateView ( ) 
method gets called when the fragment’s view gets created. We’re 
including it in our code as we want to populate the fragment’s list view 
with data as soon as it gets created. If you don’t need your code to do 
anything at this point, you don’t need to include the method. 

Let’s see how to add data to the list view. 
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Well use an ArrayAdapter to set the values in the ListView 



As mentioned in Chapter 6, you can connect data to a list view using an 
adapter. This is still the case when your list view is in a fragment; ListView is 
a subclass of the AdapterView class, and it’s this class that allows a view to 
work with adapters. 



We want to supply the list view in Workout List Fragment with an array of 
workout names, so we’ll use an array adapter to bind the array to the list view. 



This IS ouv list view. 

V 



Wc\\ cxtatt an array adapter to 
bind our list view to an array. 

ir 



This is the array. 



ListView 




Array 




Workout 






. Adapter . 




_ names 


\ 


X 


V 








X 


7 





A Fragment isn't a type of Context 

As you’ve already seen, to create an array adapter that works with a list view, 
you use: 



ArrayAdapter<DataType> listAdapter = new ArrayAdapter<DataType> ( 

context , android . R . layout . simple_list_i tem_l , array) ; 

where DataType is the type of data, array is the array and context is the 
current context. 

When we used this in an activity, we could use this to get the current context. 

We could do this because an activity is a type of context — the Activity class 
is a subclass of the Context class. 

As you saw earlier, the Fragment class isn’t a subclass of the Context class, 
so using this won’t work. Instead, you need to get the current context in some 
other way. If you’re using the adapter in the fragment’s onCreateView ( ) 
method as we are here, you can use the Layoutlnflator object’s 
getContext () method to get the context instead: 

ArrayAdapter<DataType> listAdapter = new ArrayAdapter<DataType> ( 

This you *thc ^-inflator .getContext () , android. R. layout . simple_list_item_l, 
duvveivt don'tc'X.'t- 

Once you’ve created the adapter, you bind it to the ListView using the 
fragment’s set List Adapter () method: 

setListAdapter (listAdapter) ; 

Let’s use an array adapter to populate the list view in our fragment with a list of 
workouts. 

you are here 
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Create fragments 
Link fragments 
Device layouts 



The updated WorkoutListFragment code 

We’ve updated our WorkoutListFragment.java code so that it 
populates the list view with the names of the workouts. Apply 
the changes to your code, then save your changes: 




package com. hfad. workout; 

import android . os . Bundle ; 
import android . app . ListFragment ; 
import android. view. Layoutlnf later ; 
import android . view . View; 
import android . view . ViewGroup; 



import android . widget . ArrayAdapter ; 



.tr 



□ 

Workout 

HH 

app/src/main 

L a 

java 

We've using "this class in -the W 

onCveateVW) method- com.hfad.workout 

U 



public class WorkoutListFragment extends ListFragment { 



WorkoutList 

Fragment.java 



@Override 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 

String [] names = new String [Workout .workouts . length] ; 
for (int i = 0; i < names . length; i++) { 

names [i] = Workout .workouts [i] .getName() ; ^ 

Cveate an away adapter. Create a String array ot the workout names. 

V 

ArrayAdapter<String> adapter = new ArrayAdapter<String> ( 

6(t{, "the don-te^t -pvom ^ inf later . getContext ( ) , android . R . layout . simple_lis t_i tem_l , 
the layout intlater. names) ; 

setListAdapter (adapter) ; Bind the array adapter to the list view. 



return super . onCreateView (inf later , container, savedlnstanceState); 



} 

Now that the WorkoutListFragment contains a list of 
workouts, let’s see what it looks like by using it in our activity 
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display WorkoutListFragment 
in the MainActivity layout 

We’re going to add our new 

WorkoutListFragment to our MainActivity 
layout so that it appears to the left of 
Workout Detail Fragment. Displaying fragments 
side by side in this manner is a common way of 
designing apps to work on tablets. 

To do this, we’ll use a linear layout with a horizontal 
orientation. We’ll use layout weights to control how 
much horizontal space each fragment should take up. 

Here’s the code below (update your version of activity _ 
main. xml to reflect our changes): 







V A B 15:57 


The Limb Loosener 


Core Agony 






100 Pull-ups 
100 Push-ups 


1 □ 


Core Agony 


100 Sit-ups 
1 00 Squats 




The Wimp Special 






Strength and Length 




o 











<?xml version="1.0" encoding="utf-8 " ?> 

<LinearLayout xmlns : android= M http : / / schemas . android . com/ apk/ res/ android" 
android : or ientation=" horizontal " 
android : layout_width="match_parent" 
android : layout_height="match_parent "> 

Display the list ol 



<fragment ^ — workouts -first- 

clas s=" com. hf ad. workout .WorkoutListFragment" 

android : id=" @+id/lis t_f rag" 

android : layout_width=" Odp" 

android : layout_weight=" 2 " 

android : layout_height="match_j?arent " /> 

Then display the 
workout details. 



□ 

Workout 

Hsa 

app/src/main 

41 

res 

m3 

layout 



<f ragment 

clas s=" com. hfad . workout .Workout Detail Fragment" 
android : id=" @+id/ detail_f rag" 

android: lay out_width=" Odp" WeVe usin^ layout__wei^ht to Control how 

android : layout_weight=" 3 " ^ — 

android: layout_height="match_parent " /> 

</LinearLayout> 



activity_main.xml 



y vc t c v, — 

. mudh spade eadh -fragment should take up- 



Let’s see what the app now looks like. 
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Test drive the app 



When we run the app, a list of the workouts 
appears in a list on the left of the screen, and 
details of a single workout appear on the 
right. We hardcoded which workout should 
appear in our MainActivity.java code, so no 
matter which workout the user clicks on, 
details of the Gore Agony workout will be 
displayed. 




We weed to get WorkoutPetailFragwewt to 
respowd to clicks Iw WorkoutllstFragmewt 

Here’s a reminder of where we’ve got to with our app. As you 
can see, we’ve now created all the components our app needs: 




□ 



Device 




We’re not finished coding these components though. 
Instead of displaying details of a hardcoded workout 
in WorkoutDetailFragment, we need to get it 
to display details of the workout the user clicks on in 
WorkoutList Fragment. 



fragment_ 

workout_detail.xml 
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Wiring up the list to the detail 




There are a few ways that we can make the detail change when 
an item is clicked on the list. We’ll do something like this: 



o 

o 

o 



Add code to WorkoutList Fragment that waits for a workout to be 
clicked. 

When that code runs, we’ll call some code in MainActivity.java that... 



...will change the details in the detail fragment. 



fragments 

Create fragments 
Link fragments 
Device layouts 



We don’t want to write code in WorkoutListFragment 
that talks directly to Workout Detail Fragment. Gan you 
think why? 



The answer is reuse. We want our fragments to know as little 
as possible about the environment that contains it. The more 
a fragment needs to know about the activity using it, the less 
reusable it is. 




Wait a minute! Youre saying you don't 
want the fragment to know about the 
activity that contains it? What about your 
second point? Aren't we making it depend 
on MainActivity? Won't that mean we can't 
use it in another activity? 



We need to use an interface to decouple 
the fragment from the activity. 
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We need to decouple the fragment with an interface 

We have two objects that need to talk to each other — the fragment 
and the activity — and we want them to talk without one side knowing 
too much about the other. The way we do that in Java is with an 
interface. When we define an interface, we’re saying what the minimum 
requirements are for one object to talk usefully to another. It means that we’ll 
be able to get the fragment to talk to any kind of activity, so long as 
that activity implements the interface. 

We’re going to create an interface called WorkoutListListener, 
that looks like this: 

interface WorkoutListListener { 
void itemCli eked (long id) ; 

} ; 



So long as an activity implements this interface, we’ll be able to tell it 
that an item on the list fragment has been clicked. This is what will 
happen at runtime: 



o 

o 

o 

o 



The WorkoutListListener will tell the fragment that it wants to listen. 
A user will click on a workout in the list. 

The onListltemClicked ( ) method in the list-fragment will be called. 

That method will then call the WorkoutListListener’s 
itemCli eked ( ) method with the ID of the workout that was clicked 



Put when will the activity say that it's listening? 

When will the activity tell the fragment that it’s ready to receive 
updates about what item’s been clicked? If you look back at the 
fragment lifecycle, you’ll see that when the fragment is attached to the 
activity, the fragment’s onAttach ( ) method is called with the value 
of the activity: 

@ Override 

public void onAttach (Activity activity) { 



} 

We can use this method to register the activity with the fragment. 
Let's take a look at the code. 
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First, add the interface to the list fragment ‘^- J 
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We’ve updated our WorkoutListFragment.java code to add a listener 
(apply the changes to your code, then save your work): 

package com. hf ad. workout; 

import android. os . Bundle; 
import android. app . ListFragment; 
import android. view. Layoutlnf later ; 
import android . view . View; 
import android . view . ViewGroup; 
import android . widget . ArrayAdapter ; 
import android. app. Activity; | mpoyr t -these classes. 



□ 

Workout 

HB 

app/src/main 

4U 



java 



import android, widget . ListView; 

public class WorkoutListFragment extends ListFragment { 

static interface WorkoutListListener { 
void itemClicked (long id) ; 

} ; Add "the lis-tehcr -to -the -Pvaj^e^-t- 

private WorkoutListListener listener; 






com. hfad. workout 

LB 



WorkoutList 

Fragment.java 



@Override 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 

String [ ] names = new String [Workout . workouts . length] ; 
for (int i = 0; i < names . length; i++) { 

names [i] = Workout . workouts [i] . getName () ; 

} 

ArrayAdapter<String> adapter = new ArrayAdapter<String> ( 

inf later . getContext ( ) , android. R. layout . simple_list_item_l , 
names) ; 

setListAdapter (adapter ) ; 

return super . onCreateView (inf later , container, savedlnstanceState); 



} 



@ Override 

public void onAttach (Activity activity) { 
super .onAttach( activity) ; 
this . listener = (WorkoutListListener) activity ; 

} 



This is called when -the 
-Pvaynen't attached 
-to -the activity- 



@ Override 

public void onListltemClick (ListView 1, View v, int position, long id) { 
if (listener != null) { 

listener . itemClicked (id) ; cl Ihtchcv* when ah rter* 

} ^ in the Listl/iew is clicked. 

} 
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implement WorkoutListListener 



Then make the activity implement the interface 

Now we need to make MainActivity.java implement the 
WorkoutListListener interface we just created. Update your 
code with our changes below: 

package com. hf ad. workout; 



import 

import 

public 



android . app . Activity; 

android. os . Bundle; . . . . r 

Implement the listener de+ined 

in l/VorkouiListFragmeni. 

class MainActivity extends Activity 

implements WorkoutListFragment . WorkoutListListener 



QOverride 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_main ) ; 



^ vemove ^ ese | mes as 

• xeVe no lonyv havdtodm^ 

whi t\\ workout -to display- Workout 

@ Override 

public void itemClicked (long id) { 

//The code to set the detail will go here 

} J a Y a 



■ This method is de-fined in the listener. 

t 

When an item is clicked in the fragment, the itemClicked ( ) 
method in the activity will be called. We can put code in this 
method to show the details of the workout that’s just been selected. 



app/sre/main 

HB 



m3 



com. hfad. workout 

u 



MainActivity.java 



Put how do we update the workout details? 

The Workout Detail Fragment updates its views when the 
fragment is started. But once the fragment is displayed on screen, 
how do we get the fragment to update the details? 

You might be thinking that we could play with the fragment’s 
lifecycle so that we get it to update. Instead, we’ll replace the 
detail fragment with a brand-new detail fragment, each 
time we want its text to change. 



There’s a really good reason why... 
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You want fragments to work 
with the back button 




fragments 

Create fragments 
Link fragments 
Device layouts 



Suppose a user clicks on one workout, then a second workout. When 
they click on the back button, they’re going to expect to be returned 
back to the first workout they chose. 



V A Q 11:34 



The Limb Loosener 

5 Handstand push-ups 
10 1 -legged squats 
15 Pull-ups 

The user clicks ok the Limb 
Loosener workout 



WjL Q 11:35 



The Wimp Special 




They then click OK 
the Special. 



Ta Q 11:36 



The Limb Loosener 

5 Handstand push-ups 
10 1 -legged squats 
15 Pull-ups 

\ 

When the user clicks on the 
device back button, we want 
the app to 50 back to the 
Limb Loosener workout- 



In every app we’ve built so far, the back button has returned the user 
to the previous activity. Now that we’re using fragments, we need to 
understand what happens when you click the back button. 



Welcome to the back stack 



The back stack is the list of places that you’ve visited on the device. 
Each place is a transaction on the back stack. 



A lot of transactions move you from one activity to another: 



Transaction: Go to inbox activity 
Transaction: Go to ‘compose new mail’ activity 
Transaction: Go to sent mail activity 




These are all separate 
transactions- 



So when you go to a new activity, a transaction to do that is recorded 
on the back stack. If ever you press the back button, that transaction is 
reversed, and you’re returned to the activity you were at before. 



But back stack transactions don’t have to be activities. They can just be 
changes to the fragments on the screen: 

Transaction: Replace the ‘Strength and length’ detail fragment with a ‘Core agony’ fragment 
Transaction: Replace the ‘Core agony’ fragment with ‘The wimp special’ 



That means that fragment changes can be undone with the back button, 
just like activity changes can. 
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replace fragment 



Create fragments 
Link fragments 
Device layouts 



Pon't update— instead, replace 

Instead of updating the views in WorkoutDetailFragment, we will 
replace it with a new instance of WorkoutDetailFragment set up to 
display details of the next workout that’s been selected. That way, we can 
store the fragment replacement inside a back stack transaction, and the user 
will be able to undo the change by hitting the back button. But how do we 
replace one fragment with another? 

We’ll need to begin by making a change in the activity _main. xml layout file. 
Instead of inserting WorkoutDetailFragment directly, we’ll use a 

frame layout. 

A frame layout is a type of view group that’s used to block out an area on 
the screen. You define it using the <FrameLayout> element. You use 
it to display single items — in our case, a fragment. We’ll put our fragment 
in a frame layout so that we can control its contents programmatically. 
Whenever an item in the WorkoutList Fragment list view gets clicked, 
we’ll replace the contents of the frame layout with a new instance of 
WorkoutDetailFragment that displays details of the correct workout: 



V 



Add a fragment to 
an activity using 
<fragment> il you 
don’t need it to 
respond to changes 
in the user interlace. 
Otherwise, use a 
<FrameLayout>. 



<?xml version="l . 0" encoding="utf-8 " ?> 

<LinearLayout xmlns : android="http : / / schemas . android. com/ apk/ res/android" 
android : or ientation=" horizontal" 
android : layout_width="match_parent " 
android : layout_height="match_parent "> 



□ 

Workout 



< fragment 

c las s=" com. hf ad. workout .WorkoutList Fragment" 

android: id=" @+id/list_f rag" 

android: layout_width=" Odp" 

android : layout_weight="2 " 

android : layout_height="match_parent" / > 

WeVe 0 ) 01 * 0 ) -to display the 

<FrameLayout mside 3 hameLayout- 



K3 

app/src/main 






co 

U3 

layout 



activity_main.xml 



l/Vc II add "the "to 

* -fv-arwc layou-t progv-a r*r*a-ti da I ly. 



android : id= " @ +id/ f ragmen t_con tainer " 

android: layout_width=" Odp" 
android: layout_weight="3" 
android: layout_height="match_parent" /> 
</ Linear Layout> 



Next, we’ll write the code to add the fragment to the frame layout. 
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Using fragment transactions 



You replace the fragment at runtime inside a fragment transaction. A 
fragment transaction is a set of changes you want to apply relating to the 
fragment, all at the same time. 

To create a fragment transaction, you start by getting a 
FragmentTransaction from the fragment manager: 



WorkoutDetailFragment fragment = new WorkoutDetailFragment () ; 

FragmentTransaction transaction = getFragmentManager () .beginTransaction () ; 

A 

You then specify all the actions you want to group together in the transaction. 

In our case, we want to replace the fragment in the frame layout, and we do 
this using the fragment’s replace ( ) method: 

transaction . replace (R . id . f ragmen t_container , fragment) ; 

where R. id. f ragmen t_cont a iner is the ID of the container containing 
the fragment. You may also add a fragment to a container using the add ( ) 
method, or remove a fragment using the remove ( ) method: 



The start ok the 
-Cra^ent tra*saeW 

This replaces the 
-fragment held in the 
-fragment Container. 



transaction . add (R . id . f ragmen t_container , fragment) ; you dan add or remove 
transaction . remove (fragment) ; -fragments it you wan t- In 

our example, we don t need 

You can use the setTransition () method to say what sort of transition to- 
animation you want for this transaction. 

transaction. setTransition (transition) ; You don't have to set a transition. 

where transition is the type of animation. Options for this are 
TRANSIT_FRAGMENT_CLOSE (a fragment is being removed from the stack), 

TRAN S I T_FRAGMENT_OPEN (a fragment is being added), TRANS I T_ 

FRAGMENT_FADE (the fragment should fade in and out) and TRANS I T_ 

NONE (no animation). 



Once you’ve specified all the actions you want to take as part of the transaction, 
you can use the addToBackStack ( ) method to add the transaction to the 
back stack of transactions. This allows the user to go back to a previous state 
of the fragment when they press the Back button. The addToBackStack ( ) 
method takes one parameter, a String name you can use to label the 
transaction: 



transaction . addToBackStack (null) ; ^ — 



Most o£ “the time you won't need to retrieve 
■the Iv-ansadtion, SO \i dan be set to null. 



To commit the changes to the activity, you call the commit ( ) method: 

transaction . commit () ; 



The commit ( ) method applies the changes. 
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MainActivity code 



Create fragments 
Link fragments 
Device layouts 



The updated MainActivity code 



V 



We want to get a new instance of WorkoutDetailFragment that 
displays the correct workout, display the fragment in the activity using 
a fragment transaction, and then add the transaction to the back 
button back stack. Here’s the full code: 

package com. hf ad. workout; 



□ 

Workout 

HS 

app/src/main 

43 



import android . app . Activity ; 
import android. os . Bundle; 

import android . app . FragmentTransaction ; 



VVeVe usm^ 3 -fv"3<y*cirrt 
'bvansadtiott, so we Y\ttd “to import 
-the f'va^entT'ransattiorv class. 



java 

HU 

com . hfad .workout 




public class MainActivity extends Activity MainActivity.java 

implements WorkoutListFragment . WorkoutListListener { 



QOverride 

protected void onCreate (Bundle savedlnstanceState ) { 

super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_main) ; 

} 



@Override 

public void itemClicked (long id) { S-bav-t *the 'Cv"3<y*CK‘t 

WorkoutDetailFragment details = new WorkoutDetailFragment () ; transaction. 
FragmentTransaction ft = getFragmentManager () .beginTransaction () ; 
details . setWorkout (id) ; 

. Replace -the -rv-aginen-t and 



ft . replace (R. id. f ragmen t_container, details) ; 
f t . addToBackStack (null) ; 



add i-t -to -the baek s-ta^k. 



ft.setTransition (FragmentTransaction. TRANSIT FRAGMENT FADE) new and 

- - old -h-a^ents to 

ft . commit 0;^ Coinrn)i ihe iraMatho ^ -fade in and out 



Let’s see what happens when we run the code. 
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test drive the app 

When we run the app, a list of the workouts appears in a list on the 
left of the screen. When we click on one of the workouts, details of 
that workout appear on the right. If we click on another workout 
and then click on the back button, details of the workout we chose 
previously appear on the screen. 
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rotating again 



Rotating the device breaks the app 




Create fragments 
Link fragments 
Device layouts 



When you rotate the app, there’s a problem. Regardless of which 
workout you’ve chosen, when you rotate the device, the app 
displays details of the first workout. 



• 




0 Va t 19:18 






The Limb Loosener 


The Wimp Special 

5 Pull-ups 
1 0 Push-ups 




□ 





Core Agony 


1 5 Squats 


D 




0 VJ L 19:19 I 



The Wimp Special 



Strength and Length 



Choose one o£ the 
workouts its 

details appear o * 
the ri^ht- 




When we first looked at the activity lifecycle, you saw how when 
you rotate the device, Android destroys and re-creates the activity. 
When this happens, local variables used by the activity can get lost. 
If the activity uses a fragment, the fragment gets destroyed 
and re-created along with the activity. This means that any 
local variables used by the fragment can also lose their state. 



The Limb 
Loosener 

Core Agony 

The Wimp 
Special 

Strength and 
Length 



The Limb Loosener 

5 Handstand push-ups 
10 1 -legged squats 
15 Pull-ups 

T 

l/Vhen you rota - te 
the device, details 
o-P the -first 
workout are shown 
instead- This is the 
workout with an 
inde* o-P O in the 
workouts array. 




In our WorkoutDetailFragment, we use a local variable 
called workout Id to store the ID of the workout the user clicks 
on in the WorkoutListFragment list view. When the user 
rotates the device, workout Id loses its current value and it’s set 
to 0 by default. The fragment then displays details of the workout 
with an ID of 0 — the first workout in the list. 



You deal with this problem in a fragment in a similar way to how 
you deal with it in an activity. You first override the fragment’s 
onSavelnstanceState ( ) method, and put the local variable 
whose state you want to save in the method’s Bundle parameter: 

public void onSavelnstanceState (Bundle savedlnstanceState ) { 

savedlnstanceState . putLong ( "workoutld", workoutld) ; /V , , , /N 

} ,V -The o*Save|*sta*>fce£tateO 

method gets tailed be-fove 

You then retrieve the value from the Bundle in the fragment’s -fray*ent is destroyed- 

onCreateView ( ) method: 

if (savedlnstanceState != null) { 

workoutld = savedlnstanceState . getLong ( "workoutld" ) ; 

Wc CBy\ use it to get -the previous 
state o-P the workoutld variable- 



We’ll show you the revised code on the next page. 
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The WorkoutPetailFragwent code 

package com. hfad. workout; 

. . . No new imports are required so we’ve skipped them. 

public class WorkoutDetailFragment extends Fragment { 
private long workoutld; 



□ 

out 

HT3 



Workout 



app/sre/main 

hu 

java_ 

Mn 

com. hfad. workout 

LQ 



@Override 

public View onCreateView (Layoutlnf later inf later, ViewGroup container, 

Bundle savedlnstanceState) { WorkoutDetail 

if (savedlnstanceState != null) { Fragment.java 

workoutld = savedlnstanceState . getLong ( "workoutld" ) ; £ c -|- v5 | uc ^ workoutld 



} 

return inf later . inf late (R . layout . f ragment_workout_detail , container, false); 



} 



@Override 

public void onStartO { 
super . onStart ( ) ; 

View view = getView(); 
if (view != null) { 

TextView title = (TextView) view. findViewByld (R. id. textTitle) ; 

Workout workout = Workout . workouts [( int) workoutld]; 
title . setText (workout . getName ( ) ) ; 

TextView description = (TextView) view . findViewByld (R . id . textDescription) ; 
description . setText (workout . getDescription ( ) ) ; 

} 

^ Save the value o-f the workoutld in the savedlnstanceState Bundle be-Pore the 

^ -fragment <\ets destroyed- Were retrieving it in the onCreate\/iewO method- 
0 Override V 

public void onSavelnstanceState (Bundle savedlnstanceState) { 
savedlnstanceState . putLong ( "workoutld" , workoutld) ; 

} 



public void setWorkout (long id) { 
this . workoutld = id; 

} 



* 




0 Wj 1 19:18 






The Limb Loosener 


The Wimp Special 

5 Pull-ups 
10 Push-ups 




□ 


Q 


Core Agony 


1 5 Squats 

(T 


D 




0 t 19:27 | 



The Wimp Special 
Strength and Length 



When you dlidk on one of " 
•the NMov-kouts, i-ts de-tails 
Continue -to be displayed 
when you rotate -the devide- 



The Limb 
Loosener 

Core Agony 

The Wimp 
Special 

Strength and 
Length 



The Wimp Special 

5 Pull-ups 
1 0 Push-ups 
1 5 Squats 



different screen sizes 



Phone versus tablet 




Create fragments 
Link fragments 
Device layouts 



There’s one more thing we want to do with our Workout app. 
We want to make the app behave differently depending on 
whether we’re running it on a phone or a tablet. 



Oh a tablet 

If we’re running the app 
on a tablet, we want it to 
look and behave how it 
does now. We want the 
list of workouts and the 
workout details to appear 
side by side in the same 
activity. When you click 
on a workout, its details 
appear alongside it. 



P 

The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 



The Limb Loosener 

5 Handstand push-ups 
10 1 -legged squats 
1 5 Pull-ups 



*= 1=1 



Opi a phone 

If we’re running the app on a phone, we want 
the app to behave differently. We want the list 
of workouts to appear in one activity and take 
up the full screen of the device. When you 
click on a workout, this will launch a second 
activity that displays details of the workout. 



The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 






These av-e -two 
di-f-Cev-eyrt 
activities, each 
one displaying 
a di-f-fcvent 
-fvacynent 



The Wimp Special 

5 Pull-ups 
10 Push-ups 
1 5 Squats 
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The phone and tablet app structures 

Here’s how the tablet and phone versions of the app need to work: 




Instead of using both fragments inside MainActivity, 
MainActivity will use WorkoutListFragment and 
DetailActivity will use WorkoutDetailFragment. 
MainActivity will start DetailActivity when the user 
clicks on a workout. 





activity_main.xml activity_detail.xml 




Phone 



J 



a 






WorkoutList ^ 
Fragment.java O 

Workout.java 



WorkoutDetail 

Fragment.java 



fragment_ 
workout detail.xml 



We need to get the app to look and behave differently depending 
on whether the app is run on a phone or a tablet. To help us do 
this, let’s see how we can get our app to choose a different layout 
depending on the type of device it’s running on. 
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different resources for different screens 



Put screen-specific resources in 
screen-specific folders 

Earlier in the book, you saw how you could get different devices to use 
image resources appropriate to their screen size by putting different sized 
images in the different drawable folders. As an example, you put images 
you want devices with high density screens to use in the drawable-hdpi 
folder. 

You can do something similar with other resources such as layouts, 
menus, and values. If you want to create multiple versions of the same 
resources for different screen specs, you just need to create multiple 
resource folders with an appropriate name. The device will then load the 
resources at runtime from the folder that’s the closest match to its screen 
spec. 

As an example, if you want to have one layout for large screen devices, 
and a couple of other layouts for other devices, you put the layout for the 
large device in the app/src /main/res /layout-large folder, and the layouts for 
the other devices in the app/src /main/res /layout folder. When the app gets 
run on a device with a large screen, the device will use the layout in the 
lay out- large folder: 




Create fragments 
Link fragments 
Device layouts 



□ 

app/src/main /\|| devices y/ith smaller sdreens will load 
H3 . ^the layouts -from the layout -folder. 



These two layouts will 
be used on devices with 
smaller screens. 




activity_main.xml 



activity_detail.xml 

Large devices UKe zo 

will load layout -files -from x7 layou ^" lar g^ This layout will be used by 

the layout-large -folder. fcfj devices with a large screen. 



antivitv main xml 



On the next page, we’ll show you all the different options you can use for 
your resource folder names. 
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The different folder options 



You can put all kinds of resources (drawables or images, layouts, menus, 
and values) in different folders to specify which types of device they 
should be used with. The screen-specific folder name can include 
screen size, density, orientation and aspect ratio, each part separated by 
hyphens. As an example, if you want to create a layout that will only be 
used by very large tablets in landscape mode, you would create a folder 
called layout-xlarge-land and put the layout file in that folder. Here are 
the different options you can use for the folder names: 



You musj sped i-Cy a vesouvde type- 
^1 



Sdv-een densi-ty is based 



Resource type 

drawable 
layout 
menu 
mipmap 
values 



A mipmap lresou\rde is 
used *C ov- applidaW 
idons. Oldev versions 
o* f Android S'tudio use 
drawables ins-tead- 



Screen size 


Screen density 


-small 


-ldpi 


-normal 


-mdpi 


-large 


-hdpi 


-xlarge 


-xhdpi 




-xxhdpi 




-xxxhdpi 




-nodpi ^ 




-tvdpi 



Orientation j Aspect ratio 

-land : -long 

-port • -notlong 

long is -for sdreens 
*tba*t have a very 
bi^b value -for beijbt 



This is -for densi-ty-independeni 
■ resourdes. Use — nodpi -fov- any ima^e 
resourdes you dorr t wan*t *to sdale 
(ecy, a -folder dalled drawable- 
nodpi)- 



Android decides at runtime which resources to use by looking for the 
best match. If there’s no exact match, it will use resources designed 
for a smaller screen than the current one. If resources are only 
available for screens larger than the current one, Android won’t use 
them and the app will crash. 

If you only want your app to work on devices with particular screen 
sizes, you can specify this in AndroidManif est . xml using the 
< supports- screen s> attribute. As an example, if you don’t 
want your app to run on devices with small screens, you’d use 

<supports-screens android: smallScreens="false"/> 

Using the different folder names, you can create layouts that are 
specific for phones and tablets. Let’s start with the tablet version of 
our app. 



■ 0 rr»&' or ' 0Y> 

, ov. W* W' 

! v e l^*“* r0id 

/ordtbU*' 
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exercise 



BE fjte filler Sfnicfute 

Below you'll See lire code for an 
activity. You want to display one 
layout when it runs on devices with 
large sized screens, and 
another layout when 
it runs on devices with 
normal sized screens. 
Wliich of these folder 
structures will allow you to do that? 




import android . app . Activity ; 
import android . os . Bundle ; 






tteve’s the adtwity- 



public class MainActivity extends Activity { 

@ Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_main) ; 



o □ 

app/src/main 



res 



hQ 

layout 



activity_main.xml 

4H 

layout-tablet 



activity_main.xml 



© □ 

app/src/main 



res 



H 

layout 



activity_main.xml 

HU 

layout-large-land 



activity_main.xml 
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o 



□ 

app/src/main 

43 



h3 

layout 



activity_main.xml 

43 

layout-large 



activity_main.xml 



o □ 

app/src/main 

4«a 

res 




activity_main.xml 




activity_main_tablet.xml 



o □ 

app/src/main 

Ha 



1-3 

layout-large 



activity_main.xml 

43 

layout-normal 



activityjnain.xml 



© □ 

app/src/main 



1-3 

layout 



activity_main.xml 

b3 

layout-large-land 



]</ Xmll 

activity_main.xml 

HU 

layout-large-port 



activity_main.xml 
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BE fjte filler Sfnicfute yo 

Below you'll See lire code for an 
activity. You want to display one 
layout when it runs on devices with 
large sized screens, and 
another layout when 
it runs on devices with 
smaller sized screens. 

Wliich of these folder 
structures will allow you to do that? 




import android . app . Activity ; 
import android . os . Bundle ; 



public class MainActivity extends Activity { 



@ Override 

protected void onCreate (Bundle savedlnstance State) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_main) ; 



o □ x 

app/src/main y v 

MB 



res 



Android doesn't 
redogniz^ tbe -folder 
name layout-tablet* 

adtivity_ main*m| in 
tbe layout -folder v/ill 
be displayed on all 
devides. 



HZ! 

layout 



activity_main.xml 

HU 

layout-tablet 



activity_main.xml 



res 



© □ 

app/src/main 

A devide with a large 
sdreen will use tbe layout 
in tbe layout-large-land 
-folder when it*s oriented 
landsdape* !/Vben tbe devide 
is rotated to portrait, it 
will use tbe layout in tbe 
layout -folder. 



x 



HZ) 

layout 



activity_main.xml 

4H 

layout-large-land 



activity_main.xml 
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Devides with a lav^c 
sdreen will use the 
layout in the layout- 
large -folder. Devi des 
with smaller sdreens 
will use the layout in 
the layout -folder. 




activity_main.xml 

4T3 

layout-large 

activity_main.xml 




o □ X 

app/sre/main 

HZ) 



The adtivity uses a 
layout -file dalled 
adtivity_ main.%m|. 
The layout adtivity__ 

main_*tablet-*ml 
won’t be used- 



HZ3 

layout 



activity_main.xml 



activity_main_tablet.xml 



o □ X 

app/sre/main 

na 

res 



Devi des y/ith a large 
sdreen will use the 
layout in the layout- 
large -folder. Devi des 
y/ith normal sdreens 
y/ill use the layout 
in the layout-normal 
-folder. There J s no 
layout -for devides 
y/ith a small sdreen, so 
they won’t be able to 
run the app. 



H_3 

layout-large 

activity_main.xml 

HU 

layout-normal 

activity_main.xml 





o □ 

app/sre/main 

MB 



Devides with a large 
sdreen will use the 
layout in the layout- 
large-land -folder when 
the dev ide is turned 
landsdape, and the 
layout in the layout- 
large-port -folder when 
the devide is turned 
portrait- Other devides 
will use the layout in 
the layout -folder. 




activityjnain.xml 

-□ 

layout-large-land 

activityjnain.xml 

hh 

layout-large-port 

activityjnain.xml 
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layout-large 



Tablets use layouts in the layout-large folder 




Create fragments 
Link fragments 
Device layouts 



Getting the tablet version of our app up and running is easy — all we need 
to do is put our existing activity layout file activity _main. xml into the app/ 
src /main/res /layout-large folder. The layout in this folder will then only be 
used by devices with a large screen. 

If the app /src /main/res /layout-large folder doesn’t exist in your Android 
Studio project, you’ll need to create it. To do this, switch to the Project 
view of your folder structure, highlight the app /src /main/res folder in the 
folder explorer, and choose File— >New...— ^Directory. When prompted, 
give the folder a name of “layout-large”. When you click on the OK 
button, Android Studio will create the new app /src /main/res /layout-large 
folder for you. 

To copy the activity _main. xml layout file, highlight the file in the explorer, 
and choose the Copy command from the Edit menu. Then highlight the 
new layout-large folder, and choose the Paste command from the 
Edit menu. Android Studio will copy the activity _main. xml file into the app/ 
src/ main/ res /layout-large folder. 

If you open the file, it should look like this: 




<?xml version="1.0" encoding="utf-8 " ?> 

<LinearLayout xmlns : android="http : / / schemas . android . com/ apk/ res/ android" 
android : or ien t at ion=" horizontal" 
android: layout_width="match_parent" 
android: layout_height="match_parent"> 

Workout 



u 



< fragment 

class="com. hf ad . workout . WorkoutList Fragment" 
android: id=" @+id/list_f rag" 
android: layout_width=" Odp" 
android: layout_weight="2 " 
android : layout_height="match_parent " / > 



4ffli 

app/src/main 



\Ntvt not ehan^ed 
the layout, just 
dofied it to the 
layout-lav^e -folder. 



L Q 



I CO 

LQ 

layout-large 



<FrameLayout activity_main.xml 

android: id="@+id/ f ragment_container " 
android: layout_width=" Odp" 
android: layout_weight="3" 
android: layout_height="match_parent" /> 

</ Linear Layout> 



This layout will be used by devices with a large screen, so when the app is 
run on a tablet, the two fragments will be displayed side by side. Next, let’s 
deal with the phone layouts. 
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The MainActivity phone layout 

When the app runs on a phone, we want MainActivity 
to just display WorkoutListFragment, and not 
Workout Detail Fragment. To do this, we’ll update the code 
in activity _main. xml in the app /src /main/res /layout folder so that it 
just contains WorkoutListFragment. Any phones that run 
the app will use the layout in the layout folder, whereas any tablets 
will use the layout in the layout-large folder. 

To do this, open the activity _main. xml file in the app /src /main /res/ 
layout folder, then replace the XML with the code below: 



The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 



1 Mt just Ma'mAdtvrty to 

display VVorkoutListFv-ajmcht 
cm a phone. 



<?xml version=" 1.0" encoding="utf-8"?> 

<fragment xmlns : android="http : //schemas . android.com/apk/res/android" 



class="com . hf ad . workout . WorkoutListFragment" 
android: id="@+id/list_f rag" 




Workout 



android : layout_width="match_j?arent" 
android : layout_height="match_j?arent " /> 

Make sure you edit adtivity_»>am.xj 
i» the layout -folder. 



Hn 

app/src/main 



L Q 

res _ 

la\/ni it 



layout 



As MainActivity only needs to display 

WorkoutListFragment when it’s running on a phone, there’s 
no need for us to create a separate layout that contains the 
<f ragmen t> element. This is only necessary when you need to 
display multiple fragments. 

Note that the version of activity _main. xml in the layout folder 
doesn’t contain the f ragmen t_cont a iner frame layout, 
whereas the version of activity _main. xml in the layout-large folder 
does. This is because only the version of activity _main. xml in the 
layout-large folder needs to display Workout Detail Fragment. 
Later on, we’ll be able to use this fact to figure out which layout 
the app’s using on the user’s device. 



activity_main.xml 




To get our app to 
look different on a 
phone and a tablet, 
we’re juggling two 
different layouts 
with the same 
name. 



The next thing we need to do is create a second activity that uses 
WorkoutDetailFragment. 



Take the next few pages slowly, and 
double-check you’re updating the 
correct version of the layout. 



you are here ► 



315 





create DetailActivity 



Phones will use PetailActivity 
to display details of the workout 




Create fragments 
Link fragments 
Device layouts 



We’re going to create a second activity called DetailActivity. This 
activity will contain WorkoutDetailFragment, and will be used by 
phones to display details of the workout the user selects. 

Use the Android Studio New Activity wizard to create a new blank activity 
called DetailActivity.java with a layout called activity _detail. xml. This layout 
needs to be in the app/src /main /res /layout folder so that any device can use it. 

The layout just needs to contain the fragment WorkoutDetailFragment. 
Update the code in activity jdetail. xml as follows: 



<?xml version="1.0" encoding= M utf-8 M ?> 



□ 

Workout 

4T3 

app/src/main 

La 




activity_detail.xml 



<fragment xmlns : android="http : //schemas . android.com/apk/res/android" 



class="com . hf ad . workout . WorkoutDetailFragment" 
android: id="@+id/detail_f rag" 
android : layout_width="match_j?arent" 



Pe-tailAfctwi-ty will just display 

WovkoutPetaiirv-a^ent 

dr 



android : layout_height="match_j?arent " /> 



As well as updating the activity _detail layout, we need 
to update DetailActivity itself. If the app is 
running on a phone, MainActivity will need to start 
DetailActivity using an intent. This intent will need 
to include the ID of the workout the user has selected as 
extra information. The DetailActivity will then 
need to pass this to the WorkoutDetailFragment 
using its setWorkout () method. 



* Wa Q 12:46 



The Wimp Special 

5 Pull-ups 
10 Push-ups 
1 5 Squats 




Intent 




MainActivity 



DetailActivity 




WorkoutDetailFragment 



t 

VVe need to update both o£ these activities. 
Wc II start with PetailActivity. 
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Pda] plizzje 

Your job is to take code segments from the 
pool and place them into the blank lines 
in D etoil Activity. ]avo. You may not use 
the same code segment more than 
once, and you won't need to use all 
the code segments. Your goal is to get 
the workout ID from the intent, and 
pass it to WorkoutDetailFragment. 

package com. hf ad. workout; 

import android . app .Activity ; 
import android . os . Bundle; 

WcVc using a dons-tani dor -the 

public class DetailActivity extends Activity { C*tra indorsation 

public static final String EXTRA WORKOUT ID = "id"; ,B '"ten-t so that we know 

/WainAdtivi-ty and De-fcailAd-fcivi-fcy 
arc using -the same S-tring. 

@Override 

protected void onCreate (Bundle savedlnstanceState ) { 

super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_detail ) ; 

WorkoutDetailFragment = ( ) 

(R. id. detail_frag) ; 

int workoutld = (int) getlntent ( ) . getExtras ( ) . get (EXTRA_WORKOUT_ID) ; 
WorkoutDetailFragment . setWorkout (workoutld) ; 

} 

} 
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Pool puzz]e Solution 




Your job is to take code segments from the 
pool and place them into the blank lines 
in Detail Activity. java. You may not use 
the same code segment more than 
once, and you won't need to use all 
the code segments. Your goal is to get 
the workout ID from the intent, and 
pass it to WorkoutDetailFragment. 



package com. hfad. workout; 




Create fragments 
Link fragments 
Device layouts 



import android . app .Activity; 
import android . os . Bundle; 



public class DetailActivity extends Activity { 

public static final String EXTRA_WORKOUT_ID = "id"; 

@Override 

protected void onCreate (Bundle savedlnstanceState ) { 

super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_detail ) ; 

WorkoutDetailFragment WorkoutDetailFragment = ( WorkoutDetailFragment ) 
getFragmentManager() . findFragmentByld (R. id. detail frag) ; 
int workoutld = (int) getlntent ( ) . getExtras ( ) . get (EXTRA_WORKOUT_ID) ; 
WorkoutDetailFragment . setWorkout (workoutld) ; 

} 

} 



VVe yt a lo a 

by tailing *tbc £*"a<ywen'b manager s 
t'mdfVa^mervtB'/ldO method- 

i' 
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The full PetailActivity code 



Here’s the full code for DetailActivity (replace the code 
Android Studio has generated for you with the code below): 

package com. hf ad. workout; 

import android . app . Activity ; 
import android . os . Bundle ; 

public class DetailActivity extends Activity { 

public static final String EXTRA_WORKOUT_ID = 



a 

Workout 

HU 

app/src/main 

L u 

java_ 

HU 

com. hfad. workout 

"id" ; LiUi 



DetailActivity.java 



6\c t a v-e-Cev-enfce 
Jt o the -Pira<y*ent 



@ Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 

setContentView (R. layout . activity_detail) ; ^ 

WorkoutDe tail Fragment workoutDetailFragment = (WorkoutDetailFragment) 
getFragmentManager ( ) . f indFragmentByld (R . id . de tail_f rag) ; 
int workoutld = (int) getlntent() .getExtras() . get (EXTRA_WORKOUT_ID) ; 



workoutDetailFragment . setWorkout (workoutld) ; 

} 'V 

Pass the wovkout IP to the *fva<y*cnt- 



^ “the IP of -the workout ‘the 
usc\r dlidked ov\ -from "the intent- 



The DetailActivity code gets the ID of the workout from 
the intent that started the activity. The next thing we need to do 
is get MainActivity to start DetailActivity — but only if 
the app’s being run on a phone. 

But how can we tell? 
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which layout 



Use layout differences to tell which 
layout the device is using 




Create fragments 
Link fragments 
Device layouts 



We want MainActivity to perform different actions when the user 
clicks on a workout depending on whether the device is using activity _ 
main, xml in the layout or layout-large folder. 



If the app is running on a phone, the device will be using 
activity _main. xml in the layout folder. This layout doesn’t 
include WorkoutDetailFragment, so if the user 
clicks on a workout, we want MainActivity to start 
DetailActivity. 



If the app is running on a tablet, the device will be using 
activity _main. xml in the layout-large folder. This layout includes 
a frame layout with an ID of f ragment_container that’s 
used to display WorkoutDetailFragment. If the user clicks 
on a workout in this case, we need to display a new instance of 
WorkoutDetailFragment in the f ragment_container 
frame layout. 






The Limb Loosener 



3 12:45 



Core Agony 

The Wimp Special ^ 

Strength and Length 



* 



The Wimp Special 

5 Pull-ups 
10 Push-ups 
1 5 Squats 



▼B 14:48 



The Limb Loosener 

5 Handstand push-ups 
10 1 -legged squats 
1 5 Pull-ups 

AL pctailFv-a^c^s £rar*e layout 
-fv-a^c^t^oihta'mcv only exists 
in a frfci v * ty__n\ a» n • I in the 

layout-lav-y -folder. 




The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 



We can deal with both these situations in MainActivity by checking 
which layout the device is using. We can tell this by looking for a view 
with an ID of f ragment_container. 

If f ragmen t_cont a iner exists, the device must be using activity _main. 
xml in the layout-large folder, so we know we have to display a new 
instance of WorkoutDetailFragment when the user clicks on a 
workout. If f ragmen t_cont a iner doesn’t exist, the device must be 
using the version of activity _main. xml in the layout folder, so we need to 
start DetailActivity instead. 
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The revised MainActivity code 



Here’s the full code for MainActivity.java (update your code with 
our changes): 

package com. hf ad. workout; 



import android. app .Activity; 

import android. app . FragmentTransaction; 

import android . content . Intent ; 

import android. os . Bundle; , 

. , . , WtYt using these e*tra classes 

import android, view .View; '<z . J /M . 1/N . 

m the itemCliekedO method- 



□ 

Workout 

4 T 3 

app/sre/main 

LQ 

java„ 

Mn 

com. hfad. workout 

LQ 



MainActivity.java 



public class MainActivity extends Activity 

implements WorkoutListFragment . WorkoutListListener { 



@Override 

protected void onCreate (Bundle savedlnstanceState ) { 

super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_main) ; 

} a -b the W layout that umksms 

WorkoutDetailfVa^t. This Will e*ist it the ayy 
@ Override is being run on a device with a lav-ge sdreen- 

public void itemClicked (long id) { ^ 

View fragmentContainer = f indViewBy Id (R. id. f ragmen t_container) ; 
if (fragmentContainer != null) { 

WorkoutDetailFragment details = new WorkoutDetailFragment () ; 
FragmentTransaction ft = getFragmentManager ( ) . beginTransaction ( ) ; 
details . setWorkout (id) ; 

ft . replace (R. id. fragment container , details) ; 

f t . addToBackStack (null ) ; 

ft . setTransition (FragmentTransaction . TRAN S I T_FRAGMENT_FADE ) ; 
ft . commit ( ) ; 

} else { 

Intent intent = new Intent (this, DetailActivity . class) ; 
intent . putExtra (DetailActivity . EXTRA_WORKOUT_ID , (int) id) ; 
startActivity (intent) ; 

} l-P -the -Prame layou-t isn't th ere, the app must be 

running oh a device with a smaller sdreen- ^tart 
DetailActivity, passing it the ID o( the workout- 



I/Ve only need 
to run this 
Code i-P the 
•Prame layout 
is there- 



Let's see what happens when we run the app. 
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test drive 

Create fragments 
Link fragments 
Device layouts 

When you run the app on a tablet, it appears just as before. A list 
of the workout names appears on the left of the screen, and when 
you click on one of the workouts, its details appear on the right. 

The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 






The Limb Loosener 

5 Handstand push-ups 
10 1 -legged squats 
15 Pull-ups 






'V- 



0n a 



-tablet, tbe app appeavs just as it did beW- 



Test drive the app 



V 

V 

-Hv 



When you run the app on a phone, the list of workout names 
appears on the screen. When you click on one of the workouts, its 
details are displayed in a separate activity. 



The Limb Loosener 
Core Agony 
The Wimp Special 



Strength and Length 

When you run the app on 
a phone, -the app looks 
di-rferent- Alain/tativity 
displays a single activity... 
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The Wimp Special 

5 Pull-ups 
10 Push-ups 
1 5 Squats 

* 

...and when you dlidk on a workout, 
details o( that workout are 
displayed in a separate activity- 







fragments 




Your Android Toolbox 



You’ve got Chapter 7 under 
your belt and now you’ve 
added fragments to your 
toolbox. 



Fragment lifecycle Methods 

onAttach() 




BULLET POINTS 



■ A fragment is used to control 
part of a screen. It can be 
reused across multiple 
activities. 



■ A fragment has an associated 
layout. 

■ A fragment is a subclass 

of the android . app . 
Fragment class. 

■ The onCreateView ( ) 

method gets called each time 
Android needs the fragment’s 
layout. 

■ Add a fragment to an 
activity’s layout using the 
<f ragment> element and 
adding a class attribute. 

■ The fragment lifecycle 
methods tie in with the states 
of the activity that contains the 
fragment. 

■ The Fragment class doesn’t 
extend the Activity class 
or implement the Context 
class. 



onCreate() 



Fragments don’t have a 
f indViewByld ( ) method. 
Instead, use the getview ( ) 
method to get a reference to 
the root view, then call the 
view’s f indViewByld ( ) 
method. 

A list fragment is a fragment 
that comes complete 
with a Listview. You 
create one by subclassing 

ListFragment. 



onCreateView() 



onActivityCreated() 



onStart() 



onResume() 



If you need to get a fragment 
to respond to changes in 
the user interface, use the 

<FrameLayout> element. 

Use fragment transactions to 
make a set of changes to an 
existing fragment and add to 
the back stack. 

Make apps look different on 
different devices by putting 
separate layouts in device- 
appropriate folders. 



onPause() 



onStop() 



on Destroy View() 



onDestroy() 



You tan download 
the •full tode fov 
-the thaftev fvo* 
Wtt?s : / A'myuv-Uo**/ 
tteadFixstAr'dvoid- 



onDetach() 
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8 nested frognients 



^ Dealing with Children + 




You’ve seen how using fragments in activities allow you to 
reuse code and make your apps more flexible. 

In this chapter, we’re going to show you how to nest one fragment inside another. 
You’ll see how to use the child fragment manager to tame unruly fragment transactions. 
Along the way you’ll see why knowing the differences between activities and 
fragments is so important. 



this is a new chapter 
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Creating nested fragments 

In Chapter 7, you saw how to create fragments, how to include them in 
activities, and how to connect them together. To do this, we created a list 
fragment displaying a list of workouts, and a fragment displaying details of a 
single workout. 

It’s not just activities that can contain fragments — fragments can be nested 
inside other fragments. So that you can see this in action, we’re going to add a 
stopwatch fragment to our workout detail fragment. 




l/VorkoutDe-tailFragment 
displays details o£ the 
workout the user elidks on- 



WeVe going to add a 
stopwatch -fragment to 

WorkoutDetailFragment. 



Well add a new stopwatch fragment 

We’re going to add a new stopwatch fragment 
called StopwatchFragment.java that uses a layout 
called Jragment_stopwatch.xml. We’re going to base 
the fragment on the stopwatch activity we created 
back in Chapter 4. 

We already know that activities 
and fragments behave in similar 
ways, but we also know that a 
fragment is a distinct type of 
object — a fragment is not a 
subclass of activity. Is there 
some way we could rewrite 
that activity code so that it 
works like a fragment? 



Tablet 



kLayo«t> 

l/L-ayowt 



l/Vc treated 

dll ©£ "these in 

Chapter 7. 



ac+ivi+y_main.xml 





Workou+List 

Fragment.java 



Workou+Detail 

Fragment.java 



O 

Workouts.java 



fragment_ 

workout_detail.xml 
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Stopwatch 

Fragment, java s Create 

fragment, y StopwaUhFra^entjava 

stopwatch.xml < — and its layout ne*t 







nested fragments 



Fragments and activities have similar lifecycles... 

To understand how to rewrite an activity as a fragment, we 
need to think a little about the similarities and differences 
between them. If we look at the lifecycles of fragments and 
activities, we’ll see that they’re very similar: 



Lifecycle Method 


Activity? 


Fragment? 


onAttach ( ) 




V 


onCreate ( ) 


V 


V 


onCreateView ( ) 




V 


onActivityCreated ( ) 




V 


onStart ( ) 


V 


V 


onPause ( ) 


V 


V 


onResume ( ) 


V 


V 


onStop ( ) 


V 


V 


onDestroyView ( ) 




V 


onRestart ( ) 


V 




onDestroy ( ) 


V 


V 


onDetach ( ) 




V 



...but the methods are slightly different 

Fragment lifecycle methods are almost the same as activity lifecycle 
methods, but there’s one major difference: activity lifecycle 
methods are protected and fragment lifecycle methods are 
public. And we’ve already seen that the way fragments create a 
layout from a layout resource file is different. 

Also, in a fragment, we can’t call methods like f indViewByld ( ) 
directly. Instead, we need to find a reference to a View object, and 
then call view . f indViewByld ( ) . 

With these similarities and differences in mind, it’s time you started 
to write some code... 
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This is the code for StopwatchAct ivity we wrote earlier. You're going 
to convert this code into a fragment called StopwatchFragment. With 
a pencil, make the changes you need. Keep the following things in mind: 

- Instead of a layout file called activity _stopwatch. xml, it will use a layout called 

fragment_stopwatch. xml. 

- Make sure the access restrictions on the methods are correct. 

- How will you specify the layout? 

-The runTimer ( ) method won't be able to call f indViewByld ( ) , so 
you might want to pass a view object into runTimer ( ) . 



public class StopwatchActivity extends Activity { 

//Number of seconds displayed on the stopwatch. 

private int seconds = 0; ^ - — The number o£ seconds that have passed- 



//Is the stopwatch running? 
private boolean running; ^ — 



• rump says whether the stopwatch is ru™i»g. 



private boolean wasRunning; wasfWmg says whether the stopwatch was immo 

be+ore the stopwatch was paused. 3 

@Override 

protected void onCreate (Bundle savedlnstanceState) { ^ w a s destroyed 

super . onCreate (savedlnstanceState) ; ^ ^^^restore the 

setContentView (R . layout . activity_stopwatch) ; sfobt of the variables from 

if (savedlnstanceState !=null) { ^he savedlnstanceState Bundle- 

seconds = savedlnstanceState . getlnt ( "seconds" ) ; 
running = savedlnstanceState . getBoolean ( "running" ) ; 
wasRunning = savedlnstanceState . getBoolean ( "wasRunning" ) ; 
if (wasRunning) { 
running = true; 

} 



runTimer ( ) ; „ 



-Start the runTimerO method* 



@Override 

protected void onPause () { <— Stop the stopwatch if the activity is paused- 

super . onPause ( ) ; 
wasRunning = running; 
running = false; 

} 
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@Override 

protected void onResume () 
super . onResume ( ) ; 
if (wasRunning) { 
running = true; 



• start the sfcofwatth the activity is rtamed. 



} 






Save -the activity's state be-Pore 
the ad-tivi-ty is destroyed- 



@Override 

protected void onSavelnstanceState (Bundle savedlnstanceState) 
savedlnstance State . put In t ( "seconds" , seconds ) ; 
savedlnstanceState . putBoolean ( " running " , running) ; 
savedlnstanceState . putBoolean ( "wasRunning" , wasRunning) ; 

} 



public void onClickStart (View view) { 
running = true; 

} 

public void onClickStop (View view) 
running = false; 

} 




public void onClickReset (View view) 
running = false; 
seconds = 0; 



■/ 



Start, stop or reset the stopwatch 
depending on which button is dlidked- 



} 






Use a Handler to post Code to 
increment the number ot seconds and 
update the te*t view every second- 



private void runTimer () { 

final TextView timeView = (TextView) f indViewByld (R . id . time_view) , 
final Handler handler = new Handler (); 
handler . post (new Runnable () { 

@Override 

public void run ( ) { 

int hours = seconds / 3600; 

int minutes = (seconds % 3600) / 60; 

int secs = seconds % 60; 

String time = String . format ( "%d: %02d: %02d", 
hours, minutes, secs) ; 
timeView . setText (time) ; 
if (running) { 
seconds++; 



handler . postDelayed (this , 1000) ; 



} 



} 
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This is the code for StopwatchAct ivity we wrote earlier. You're going 
to convert this code into a fragment called StopwatchFragment. With 
a pencil, make the changes you need. Keep the following things in mind: 

- Instead of a layout file called activity_stopwatch.xml, it will use a layout called 

fragment_stopwatch. xml. 

- Make sure the access restrictions on the methods are correct. 



- How will you specify the layout? 



This is -the hew name* 



V 



-The runTimer ( ) method won't be able to call f indViewByld ( ) , so 
you might want to pass a view object into runTimer ( ) . 



public class Stopy/atdhFVayheht extends { 

//Number of seconds displayed on the stopwatch. 

private int seconds = 0; WeVe e*tehdih^ 

//Is the stopwatch running? Fra^ent, *°*t Activity, 

private boolean running; 
private boolean wasRunning; 

^ k^This method needs to be Public 

@ Override 

public void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; /(/"You don t set a -(Varment's layout 

in its onCreateO method- 

if (savedlnstanceState != null) { 

seconds = savedlnstanceState . getlnt ( "seconds" ) ; 
running = savedlnstanceState . getBoolean ( "running" ) ; 
wasRunning = savedlnstanceState . getBoolean ( "wasRunning" ) ; 
if (wasRunning) { 

running = true; ^ ^ | cavc ^his m the ohCreateO method- 

} 

} 

|/Ve ve hot eallih^ v-uhTimevO yet because we^ve 
} hot set the layout— we doh*t have ahy views yet* 

$0vemde We set the fragment's layout m 

publid l/iew onCveate\/ieY/(Layout|n-flatev- inf later, Vieu/^jv-oup dontainer, the onCreatel/iewO method- 
Bundle savedlnstandeState) { 

l/ievj layout — inflaterinflate(R-layout-fra9ment_stop'watdh, dontainer, -false); 

^ PaSS ihC lay ° ui VievJ *™Tim erO method- 



-This 



@Override 

fublid void 
super . onPause ( ) ; 
wasRunning = running 
running = false; 

} 



ethod heeds to be publid* 

onPause ( ) { 
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@Override 






This method needs to be fublid. 



r^e^K fublid void onResume () { 

super . onResume ( ) ; 
if (wasRunning) { 
running = true; 



} 



^This method needs to be Public 

@Override 

fublid void onSavelnstanceState (Bundle savedlnstanceState) 
savedlnstanceState .putlnt ("seconds", seconds) ; 
savedlnstanceState .putBoolean ( "running" , running) ; 
savedlnstanceState .putBoolean ( "wasRunning" , wasRunning) ; 

} 



{ 



public void onClickStart (View view) { 
running = true; 

} 

public void onClickStop (View view) { 
running = false; 

} 



public void onClickReset (View view) { 
running = false; 
seconds = 0; 

^Tbe \runTime\rO method now takes a V\ ev/. 

private void runTimer ( \/i ew view ) { 

final TextView timeView = (TextView) view, f indViewByld (R. id. time_view) ; 

final Handler handler = new Handler (); ^ Mse ^ V|ew pa vametev b> Mil {mdl/iewRyldO. 

handler . post (new Runnable () { 

@Override 

public void run ( ) { 

int hours = seconds / 3600; 

int minutes = (seconds % 3600) / 60; 

int secs = seconds % 60; 

String time = String . format ( "%d: %02d : %02d" , 
hours, minutes, secs) ; 
timeView . setText (time) ; 
if (running) { 
seconds+i; 



handler . postDelayed (this , 1000) ; 

} 



} 



} 
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StopwatchFragment code 



The StopwatchFragment code 

We’ll add StopwatchFragment to our Workout project so that we can 
use it in our app. You do this in the same way you did in Chapter 7. Go to 
File— >New...— ^Fragment— ^Fragment (Blank). Give the fragment a name of 
“StopwatchFragment”, a layout name of “fragment_stopwatch”, and untick the 
options for including fragment factory methods and interface callbacks. 

When you click on the Finish button, Android Studio creates a new fragment for 
you in a file called StopwatchFragment.java in the app /src /main /java folder. Replace 
the fragment code Android Studio gives you with the following code (this is the 
code you updated in the exercise on the previous page): 



package com. hf ad. workout; 

import android . os . Bundle; 
import android . os . Handler ; 
import android . app . Fragment ; 
import android . view . Layoutlnf later ; 
import android . view .View; 
import android . view . ViewGroup; 
import android . widget . TextView; 



□ 

Workout 



HU 

app/src/main 



4T3 



java 



LQ 



com . hfad .workout 

l_u 



public class StopwatchFragment extends Fragment { 

//Number of seconds displayed on the stopwatch. 

private int seconds = 0; ^ number o$ seconds 'that have passed- 

//Is the stopwatch running? 

private boolean running;^ running says whether the ^ is running 

private boolean wasRunning; wasRunning says whe-fcher the stopwateh 



Stopwatch 

Fragment.java 



Restore the state ot the variables 
A .from the savedktanteState Bundle. 



be-fore the stopwatch was paused- 

@Override 

public void onCreate (Bundle savedlnstanceState) 
super . onCreate (savedlnstanceState) ; 
if (savedlnstanceState != null) { 

seconds = savedlnstanceState . getlnt ( "seconds" ) ; 
running = savedlnstanceState . getBoolean ( "running" ) ; 
wasRunning = savedlnstanceState . getBoolean ( "wasRunning" ) ; 
if (wasRunning) { 
running = true; 

} 



was rubbing 



} 



332 Chapter 8 



nested fragments 



The StopwatchFragment code (continued) 

@Override 

public View onCreateView (Layoutlnf later inf later , ViewGroup container, 

Bundle savedlnstanceState ) { 

View layout = inf later . inf late (R . layout . f ragment_stopwatch, container, false); 

runTimer (layout) ; -fragment's layout, and start the 

return layout; runTWrO method passing in the layout 

} 



@Override 

public void onPause () { 

super . onPause ( ) ; 
wasRunning = running; 
running = false; 

} 



It the -fragment s paused, 

. record whether the stopwatch 
was running and stop it- 



□ 

Workout 

L cu 

app/sre/main 

MB 

java 



@Override 

public void onResume () { 

super . onResume ( ) ; 
if (wasRunning) { 

running = true; |f -the stopwatch was (running beW it 



was paused, set it (running again. 



MO 



com. hfad. workout 

LQ 



Stopwatch 

Fragment.java 



} 



@Override 

public void onSavelnstanceState (Bundle savedlnstanceState) 
savedlnstanceState .putlnt ( "seconds" , seconds); ^ 
savedlnstanceState . putBoolean ( "running" , running) 



Put the values o-P the 

variables in the Bundle 

. 1 > be-foire the activity is 

destroyed- These are 



destroyed. These ave 

savedlnstanceState . putBoolean ( "wasRunning" , wasRunning); used when the 

turns the device. 



public void onClickStart (View view) { 
running = true; 

This tode needs to run when the user 
} tlicks on the Start button. 

The tode Continues 
on the next page. 
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code continued 



The StopwatchFragwent code (continued) 



public void onClickStop (View view) { 



running = false; 



This Code needs -ho run when the user 
clicks on the stop button. 



public void onClickReset (View view) { 

• A 

This Code needs t o run when "the user 
didks on -the Reset button- 



running = false; 
seconds = 0; 



□ 

Workout 

Ha 

app/sre/main 

KU 

java_ 

HU 

com . hfad .workout 

L @ 

Stopwatch 

Fragmentjava 



— Putting "the Code, in a Handler means it 
ddn run in the badkeyround thread- 



private void runTimer (View view) { 

final TextView timeView = (TextView) view. findViewByld (R. id. time_view) ; 
final Handler handler = new Handler (); 
handler . post (new Runnable () { 

OOverride 

public void run ( ) { 

int hours = seconds / 3600; 
int minutes = (seconds % 3600) / 60; 
int secs = seconds % 60; 

String time = String . format ( "%d: %02d: %02d", 
hours, minutes, secs) ; 

timeView. setText (time) ; ^ — .. pisplay the number o£ seconds that 

if (running) { 
s 



have passed in the stopwatch- 

seconds + + ; ^ ^ , s ^ ^ 



} 

handler .postDelayed (this, 1000) ; 



}) ; 



Run the Handler Code every second 



That’s all the Java code we need for our 
StopwatchFragment. The next thing we need to do is say 
what the fragment should look like by updating the layout code 
Android Studio gave us. 
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The StopwatchFragment layout 

We’ll use the same layout for StopwatchFragment as we 
used in our original Stopwatch app. Replace the contents of 
fragment_stopwatch.xml with the code below: 



<?xml version="1.0" encoding="utf-8 " ?> 

<RelativeLayout xmlns : android="http : / / schemas . android . com/ apk/ res/ android" 
xmlns : tools="http : / / schemas . android . com/ tools" 
android : layout_width="match_parent" 
android : layout_height="match_parent "> 



<TextView 

android : id=" @+id/ time_view" 
android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android : layout_alignParentTop="true" 
android : layout_centerHorizontal="true" 
android : layout_marginTop=" Odp" 
android : text=" " 

android : textAppearance=" ?android : attr/ textAppearanceLarge" 
android : textSize=" 92sp" /> 

<Button 

android: id="@+id/ start_button" 
android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android : layout_below=" @+id/ time_view" 
android : layout_centerHorizontal="true 
android : layout_marginTop="2 Odp" 
android : onClick="onClickStart" 
android: text="@string/ start" /> 

The Start 



□ 

out 

K3 



Workout 



app/src/main 

Ha 



CO 

LQ 

layout 



fragment_ 
stopwatch. xml 



The humbev" houvs, minutes* 
and setonds -that have passed- 



button 



0 : 00:00 



<Button 

android: id="@+id/ stop_button" 
android : layout_width="wrap_content" 
android : layout_height="wrap_content " 
android: layout_below=" @+id/ start_button" 
android : layout_centerHorizontal="true" 
android : layout_marginTop=" 1 Odp" 
android : onClick="onClickStop" 
android: text="@string/stop" /> 



The S*bo\> button 



Start 



Stop 



Reset 



The Rcsci 
but-ton ^ode 
is oh the 

next page.. 
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layout continued 



The StopwatchFragwewt layout (continued) 



<Button 

android: id="0+id/ reset_button" 
android: layout_width="wrap_content " 
android: layout_height="wrap_content" 
android: layout_below=" @+id/ stop_button 
android : layout_centerHorizontal="true" 
android : layout_marginTop=" 10dp" 
android: onClick="onClickReset" 
android: text="0string/ reset" /> 
</RelativeLayout> 



The Reset button 



The StopwatchFragwent layout uses String values 

The XML code in fragment_stopwatch.xml uses string values for the text 
on the Start, Stop, and Reset buttons. We need to add these to strings, 
xml : 



<string name="start">Start</string> 
<s tr ing name= " s top " >S top</ s tr ing> 
<string name="reset">Reset</string> 



These are -the 



bu-bton labels. 



The Stopwatch fragment looks just like it did when it was an activity. 
The difference is that we can now use it in other activities and 
fragments. 



The sboywabth looks *the 
sa^e as ft did when ft 
was a* ac-tivfty. Because^ 
iVs now a -fraynenb) we 

tan reuse i*t in di-f-feren-t 
activities and -fv-a^en'ts- 



The next thing we need to do is display it when we show the user 
details of the workout they choose. 



0:00:00 

Start 

Stop 

Reset 



□ 

Workout 

Hr] 

app/sre/main 

4T3 

res 




strings.xml 
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Adding the stopwatch fragment to 
WorkoutPetailFragment 



We’re going to add the StopwatchFragment inside 
the WorkoutDetailFragment. The user interface of 
MainActivity on a tablet will link together like this: 



/WamAfrtWiiv ton-tarns W> tay»e*-b, 
Wbv-kou-tListrv-a^men-t and VVorkou-tDe-tailPra^en-t. 




The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 

4 

This is 

Wovkou- tListFv-ajrnen-t- 



Ihe W'mp speca^ „ 



ups 
10 Push-ups 
1 5 Squats 



0:00:00 



. * 

tVovkoutDc-tailFy-agmch-t 

will doh*t«iih Start 

the -Pvagmeht 

Stopy/a*(ihF\ragmeht- Stop 

Reset 




We need to add it programmatically 

You’ve seen that there are two ways of adding a fragment, using a 
layout file and writing Java code. If you add a fragment to another 
fragment’s layout the result can be flaky, so we’re going to add the 
StopwatchFragment to the WorkoutDetailFragment 
using Java code. That means we’re going to do it in almost the 
same way that we added the WorkoutDetailFragment to 
the activity There’s just one difference which we’ll come to. 



II you nest fragments 
inside fragments, 
you need to add the 
nested fragment 
programmatically. 
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add frame layout 



Add a FrameLayout where the 
fragment should appear 

As you saw in Chapter 7, to add a fragment programmatically 
using Java code, you add a frame layout to your layout where 
you want the fragment to go. 

We want to put our StopwatchFragment in 
Workout Detail Fragment underneath the workout name 
and description. We’ll add a frame layout underneath the 
name and description text views that will be used to contain 
StopwatchFragment: 



□ 

Workout 

Ha 

app/src/main 

43 



fragment_ 

workout_detail.xml 




<?xml version="1.0" encoding="utf-8 " ?> 

<LinearLayout xmlns : android="http : / / schemas . android . com/ apk/ res/ android" 
android: layout_height="match_parent" 
android : layout_width="match_parent " 
android : or ientation=" vertical "> 



CTextView 

android : layout_width="wrap_content" 
android: layout_height="wrap_content" 

android: textAppearance=" ?android : attr/ textAppearanceLarge" 
android : text=" " 
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Then display the fragment in Java code 



We want to add StopwatchFragment to the frame layout 
when WorkoutDetailFragment’s view gets created. We’ll 
do this in a similar way to how we did in Chapter 7, by replacing 
the fragment that’s displayed in the frame layout using a fragment 
transaction. Here’s a reminder of the code we used in Chapter 7: 



4 



Crea-te a new instance be 
-Cragmeni you wish -to display- 



WorkoutDetailFragment details = new WorkoutDetailFragment ( ) ; 



S-tav-t -the 



FragmentTransaction ft = getFragmentManager ( ) . beginTransaction ( ) ; ^ — 
ft . replace (R. id . f ragment_container , details) ; *the -fragment and 



ft . addToBackStack (null) ; 



> add it to -the badk stadk. 



-fragment 

transaction. 



ft . setTransition (FragmentTransaction . TRANSIT_FRAGMENT_FADE) ; ^ 

ft . commit ( ) ; ^ — Commit the transaction. -fragments to fade in and out 



We used the above code to replace the fragment that’s displayed 
in an activity, but this time there’s a key difference. Instead of 
replacing the fragment that’s displayed in an activity , we want to 
replace the fragment that’s displayed in a fragment. This means 
that we need to make a small change to how we create the 
fragment transaction. 

When we wanted to display a fragment in an activity, we created 
the fragment transaction using the activity’s fragment manager 
like this: 

FragmentTransaction ft = getFragmentManager (). beginTransaction () ; 



This gets a reference to the 
activity’s fragment manager. 



The getFragmentManager ( ) method gets the fragment 
manager associated with the fragment's parent activity. This means 
that the fragment transaction is linked to the activity. 

When you want to display fragments inside another fragment, 
you need to use a slightly different fragment manager. You need 
to use the fragment manager associated with the parent fragment 
instead. This means that any fragment transactions will be linked 
to the parent fragment rather than the activity. 

To get the fragment manager that’s associated with the parent 
fragment, you use the getChildFragmentManager ( ) 
method. This means that the code to begin the transaction looks 
like this: 

FragmentTransaction ft = getChildFragmentManager (). beginTransaction () ; 



This gets a re-ferende to -the 
^ -fragments fragment manager. 

V 



So what difference does using getChildFragmentManager ( ) 
make in practice? 
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fragment transactions 



getFragmentManagerO creates 
transactions at the activity lavel 

Let’s first look at what would happen if our 

WorkoutDetailFragment used getFragmentManager ( ) to 
create the fragment transaction to display StopwatchFragment. 

When someone clicks on a workout, we want the app to display the 
details of the workout and the stopwatch. MainActivity creates 
a transaction to display WorkoutDetailFragment. If we use 
getFragmentManager ( ) to display the StopwatchFragment as 
well, we’ll have two transactions on the back stack. 



> 



'V f 

. , getFragmentManagerO -fov both transadtions 

Peware the back button adds two transadtions to the back sbadk. 

The problem with using two transactions to display the workout is that 
weird things happen if the user presses the back button. 

When a user clicks on a workout, and then clicks the back button, they 
will expect the screen to go back to how it looked before. But the back 
button simply undoes the last transaction on the back stack. 

That means if we create two transactions to the workout detail and the 
stopwatch, if the user clicks the back button then all that will happen is 
the stopwatch will be removed. They have to click it again to remove the 
workout detail section. 



Display the stopwatch fragment. 



Display the detail fragment. 



The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 



The Wimp Special 

5 Pull-ups 
10 Push-ups 
1 5 Squats 



0:00:00 



The user dieks a* iter* 
m “the list just c mde to 
display the workout 
details a*d stopwatch. 



Stop 



Reset 



The user has -to dlidk -the Badk button 
twide to get badk to where they 
started- Clidking the Badk button 
onde only removes the stopwatdh. 





Core Agony 

The Wimp Special 

Strength and Length 
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Nested fragments need nested transactions 

The problem of having multiple transactions for 
nested fragments was why the child fragment manager 
was created. The transactions created by the child 
fragment manager fit inside the main transactions. So 
when we add the StopwatchFragment to the 
Workout Detail Fragment using a transaction 
created by getChildFragmentManager ( ) . 
beginTransaction ( ) , the transactions are nested like this: 



Display the detail fragment. 



Display the stopwatch fragment. 



Usmoj b> 

display "the stopwatch means "that "the 

■bransatW to display the stopwatch 
is nested inside the transaction to 
display the detail trao^ent 



The back stack has one transaction that contains the second 
transaction. When someone presses the back button, the 
display -the- detail-fragment transaction is undone, and that will 
mean that the display-the-stopwatch-fragment transaction is 
undone at the same time. When the user presses the back 
button, the app behaves correctly: 



□ III 



The Limb Loosener 
Core Agony 



The Wimp Special 

5 Pull-ups 
10 Push-ups 
1 5 Squats 



% 13:28 




□ ■ 



This time -the user has to press 
"the Back button just onCe -to 
undo both the workout detail 
and stopwatch transactions. 



% ^ Q 13:30 



The Wimp Special 
Strength and Length 



0 : 00:00 



Stop 



Reset 



The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 



you are here ► 



341 




replace fragment 



display the fragment in its parent's 
onCreateViewi) method 

We want to add StopwatchFragment to the frame layout 
when WorkoutDetailFragment’s view gets created. 

When WorkoutDetailFragment’s view gets created, its 
onCreateView ( ) method gets called, so we’ll add a fragment 
transaction to the onCreateView ( ) method to display 
StopwatchFragment. Here’s the code: 

@Override 




Workout 



Hia 

app/src/main 

4H 

java_ 

LQ 

com.hfad.workout 




WorkoutDetail 

Fragment.java 



public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 
if (savedlnstanceState != null) { 

workoutld = savedlnstanceState . getLong ( "workoutld" ) ; S-fe^vt “the 



} 



^ tv-an 



sadfion. 



FragmentTrans action ft = getChildFragmentManager () .beginTransaction () ; 
Add “the StopwatchFragment StopwatchFragment = new StopwatchFragment () ; 

■fo-ansa^t'ion *to f t . replace (R . id . s topwatch_container , StopwatchFragment) ; 

■the badk stadk. . addToBackStack (null) ; 

f t . setTransition (FragmentTransaction . TRANSIT_FRAGMENT_FADE) 

& ft . commit () ; 

return inf later . inf late (R . layout . detail , container, false); 



Reflate the -(Varment 
in the ta*»e layout- 



Coffimnrb 

•b-ansatW* . 



} 



”tv-a^si-tioh 

ahir^a-tion 

style. 



As you can see, the code looks almost identical to the code used 
to display a fragment inside an activity. The key difference is 
that we’re displaying a fragment inside another fragment, so 
we need to use getChildFragmentManager ( ) instead of 
getFragmentManager ( ) . 

We’ll show you the full code for WorkoutDetailFragment 
on the next page, and then see how it runs. 



there-tWCe no 

Dumb Questions 



v I can see that the child fragment manager handles the 
case where I put one fragment inside another. But what if I put 
one fragment inside another, inside another, inside another...? 



The transactions will all be nested within each other, leaving 
just a single transaction at the activity level. So the nested set of 
child transactions will be undone by a single Back button click. 
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The full WorkoutPetailFragwent code 

Here’s the full code for WorkoutDetailFragment.java : 



package com. hf ad . workout ; 

import android. app . Fragment; 

import android. os . Bundle; 

import android . view . Layout Inf later ; 

import android . view . View; 

import android. view. ViewGroup; 

import android . widget . TextView; 

import android . app . FragmentTransaction ; 



1/VcVc usi 

Fv-a^ch-tTva^sadtioh dass, 
so v/cVc imfortmj it 



□ 

Workout 

app/src/main 

java_ 

mu 

com. hfad. workout 

L_C 



public class WorkoutDetailFragment extends Fragment { 
private long workoutld; 



WorkoutDetail 

Fragment.java 



@Override 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 
if (savedlnstanceState != null) { 

^ workoutld = savedlnstanceState . getLong ( "workoutld" ) ; 

FragmentTransaction ft = getChildFragmentManager () .beginTransaction () ; 
Jra*sadtioh StopwatchFragment stopwatchFragment = new StopwatchFragment () ; 

"to add tie J ft. replace (R. id. stopwatch_container , stopwatchFragment) ; 
s-fcopwa-tdh " ft . addToBackS tack (null) ; 

-fv"ac\rr\Ch{ ft ’ se tTransition (FragmentTransaction . TRANSIT_FRAGMENT_FADE) ; 

the *(raw»e ^ ^ ’ comm ^ ( ) ' 

. . return inf later . inf late (R . layout . fragment workout detail, container, false) 

layout- } — — 



@Override 

public void onStart() { 
super . onStart ( ) ; 

View view = getView(); 
if (view != null) { 

TextView title = (TextView) view. findViewByld (R. id. textTitle) ; 

Workout workout = Workout .workouts [ (int) workoutld]; 
title . setText (workout . getName ( ) ) ; 

TextView description = (TextView) view . findViewByld (R . id . textDescription) 
description . setText (workout . getDescription ( ) ) ; 






These methods don't need to dhan^e- 

@Override Vd_ 

public void onSavelnstanceState (Bundle savedlnstanceState) { 
savedlnstanceState . putLong ( "workoutld" , workoutld) ; 

} 



public void setWorkout ( long id) { 
this . workoutld = id; 

} 
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test drive 




Test drive the app 



Now that you’ve added the code to display the stopwatch, let’s 
run the app and check that it works. 

If you select one of the workouts, the workout detail appears 
along with the stopwatch. If you click on the Back button, the 
whole screen goes back to how it looked before: 



The Limb Loosener 



The Wimp Special 



5 Pull-ups 
1 0 Push-ups 
1 5 Squats 



Core Agony 
The Wimp Special 
Strength and Length 

& 

When you elick on 
a workout, the 
workout details a*d 
stopwatch appear. 



0:00:00 



Start 



Stop 



n 



The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 



Put there's a problem If you try to Interact 
with the stopwatch 

If you try to press one of the buttons on the stopwatch, a weird 
thing happens. The app crashes: 



When you dick on the back 
button, the transactions to 
add the stopwatch and the 
workout details are both 
rolled back. This is because 
the transaction to add the 
stopwatch is nested in the 
transaction to add the 
workout details. 




Let’s look at what went wrong. 
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Why does the app crash if you press a button? 

When we converted the stopwatch activity into a fragment, we 
didn’t change any of the code relating to the buttons. We know 
this code worked great when it was in an activity, so why should it 
cause the app to crash in a fragment? 

Here’s the error output from Android Studio. Gan you see what 
may have caused the problem? 
— 

01-24 17:37:00.326 2400-2400/com. hf ad. fraghack E/AndroidRuntime : FATAL EXCEPTION: main 

Process: com. hf ad. fraghack, PID: 2400 

java. lang. IllegalStateException: Could not find a method onClickStart (View) in the activity 
class com. hf ad. fraghack. MainActivity for onClick handler on view class android. widget . 

Button with id ' start_button ' 

at android. view. View$l . onClick (View. java: 3994) 
at android. view. View. per formClick (View. java : 4756) 
at android . view . View$Perf ormClick . run (View . j ava : 1 97 4 9 ) 
at android . os . Handler . handleCallback (Handler . j ava : 7 3 9 ) 
at android. os .Handler .dispatchMessage (Handler . java: 95) 
at android. os .Looper. loop (Looper. java: 135) 

at android. app. ActivityThread. main (ActivityThread. java: 5221) 
at j ava . lang . reflect . Method . invoke (Native Method) 
at java. lang. reflect .Method. invoke (Method. java: 372) 

at com. android. internal . os . ZygoteInit$MethodAndArgsCaller . run (Zygotelnit .java : 899) 
at com. android. internal . os . Zygotelnit .main (Zygotelnit .java: 694) 

Caused by: java. lang. NoSuchMethodException: onClickStart [class android. view. View] 
at j ava. lang. Class. getMethod( Class. java: 664) 
at j ava. lang. Class. getMethod( Class. java: 643) 
at android. view. View$l . onClick (View. java: 3987) 
at android. view. View. per formClick (View. java : 4756) 
at android . view . View$Perf ormClick . run (View . j ava : 1 97 4 9 ) 
at android . os . Handler . handleCallback (Handler . j ava : 7 3 9 ) 
at android. os .Handler .dispatchMessage (Handler . java: 95) 
at android. os .Looper . loop (Looper . java: 135) 

at android. app. ActivityThread. main (ActivityThread. java: 5221) 
at j ava . lang . reflect . Method . invoke (Native Method) 
at j ava . lang . reflect . Method . invoke (Method . j ava : 372 ) 

at com. android. internal . os . ZygoteInit$MethodAndArgsCaller . run (Zygotelnit . java : 899) 
at com. android. internal . os . Zygotelnit .main (Zygotelnit .java: 694) 
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on Click revisited 



let's look at the StopwatcbFragwent layout code 



In the layout code for the StopwatchFragment, we’re binding 
the buttons to methods in the same way that we did for an activity by 
using the android: onClick attribute to say which method should 
be called when each button is clicked: 

<?xml version="l . 0" encoding="utf-8 " ?> 



VVeVe us the same layout -for 
tl^c stopu/atth i^ou/ that a 
•fragment as xe did when it xas an 

Y~ at-twi-by- 



<RelativeLayout xmlns : android="http : / / schemas . android. com/ apk/ res/ android" 



<Button 

android: id="@+id/ start_button" 
android : layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: layout_below=" @+id/ time_view" 
android: layout_centerHorizontal="true" 
android : layout_marginTop="20dp" 
android : onClick= " onCl ickS tart " 
android: text="@ string/ start" /> 

<Button 

android: id="@+id/ stop_button" 
android: layout_width="wrap_content" 
android : layout_height="wrap_content" 
android: layout_below=" @+id/ start_button" 
android : layout_centerHorizontal=" true" 
android: layout_marginTop=" lOdp" 

android: onClick="onClickS top" 

android: text="@string/stop" /> 



<Button 

android: id="@+id/ reset_button" 
android : layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: layout_below=" @+id/ stop_button" 
android: layout_centerHorizontal="true" 
android : layout_marginTop=" lOdp" 
android: onClick="onClickReset" 
android: text="@ string/ reset" /> 
</RelativeLayout> 



□ 

Workout 

lo 

app/src/main 

mb 

res 

4a 

layout 



fragment_ 
stopwatch. xml 



IA/cVc using the android-onClitk 
- attributes m the layout to say 
y/bieb methods should be ealled 
when eath button is tlitked- 



So why should we have a problem now that we’re using a fragment? 
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The onClick attribute calls methods 
in the activity, not the fragment 

There’s a big problem with using the android: onClick 
attribute to say which method should be called when a view is 
clicked. The attribute specifies which method should be called 
in the current activity. This is fine when the views are in an 
activity's layout. When the views are in a fragment this leads to 
problems. Instead of calling methods in the fragment, Android 
calls methods in the parent activity. If it can’t find the methods in 
this activity, the app crashes. 

The problem occurs regardless of whether the fragment is 
included in an activity, or nested inside another fragment. It 
applies to all fragments. 

It’s not just buttons that have this problem. The 
android : onClick attribute can be used with any views that 
are subclasses of the Button class. This includes checkboxes, 
radio buttons, switches, and toggle buttons. 

Now we could move the methods out of the fragment into the 
activity, but that approach has a major disadvantage. It would 
mean that the fragment is no longer self-contained — if we 
wanted to reuse the fragment in another activity, we’d need to 
include the code in that activity too. Instead, we’ll deal with it in 
the fragment. 




Activity 



How to make button clicks call methods in the fragment 



There are two things you need to do in order to get buttons in a 
fragment to call methods in the fragment instead of the activity: 



© 

G 



Remove references to android :onClick in the fragment layout. 

Buttons attempt to call methods in the activity when the android: onClick 
attribute is used, so these need to be removed from the fragment layout. 

Bind the buttons to methods in the fragment by implementing an 
onClickListener. 

This will ensure that the right methods are called when the buttons are clicked. 



Let’s do this now in our StopwatchFragment. 
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remove on Click 



First, remove the onClick attributes 
from the fragment's layout 



The first thing we’ll do is remove the android : onClick lines 
of code from the fragment’s layout. This will stop Android trying 
to call methods in the activity when the buttons are clicked: 

<?xml version-" 1 . 0" encoding="utf-8" ?> 

<RelativeLayout xmlns : android="http : / / schemas . android . com/ apk/ res/ android" 



android: id="@+id/ stop_button" 
android : layout_width="wrap_cont' 
android : layout_height="wrap_con 
android: layout_below=" 0+id/ star 
android: layout_centerHorizontal : 



android: id="0+id/ reset_button" 
android : layout_width="wrap_cont' 
android : layout_height="wrap_con 
android: layout_below=" 0+id/ stop 
android : layout_centerHorizontal : 
android : layout_marginTop=" lOdp" 

android: text=" 0 string/ reset" /> 



</RelativeLayout> 

The next thing is to get the fragment to respond to button clicks. 



<Button 




android: id=" 0+id/ start button" 



Workout 



android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android : layout_below=" 0+id/ time_view" 
android : layout_centerHorizontal="true" 




app/src/main 




res 



android : layout_marginTop="20dp" 
android: text=" 0string/ start" /> 




<Button 




fragment_ 
stopwatch. xml 



android: text="0string/stop" /> 



android : layout_marginTop=" lOdp" 



Remove -the onCfidc 

attributes -for eadb 
o-f tbe buttons *m 
tbe 



<Button 
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Make the fragment implement OnClickListener 

To make the buttons call methods in StopwatchFragment when they are clicked, * ^ 

we’ll make the fragment implement the View . OnClickListener interface like This -the -brazen 

tPjg. nr\”to O^CIi^hL-is*bcy\CV"- 

4 

public class StopwatchFragment extends Fragment implements View. OnClickListener { 



} 

This turns StopwatchFragment into a type of View . OnClickListener so 
that it can respond to when views are clicked. 

You tell the fragment how to respond to clicks by implementing the 

View . OnClickListener onClick ( ) method. This method gets called 

whenever a view in the fragment is clicked. 

©Override 

public void onClick (View v) { ^Vou must override the onCliekO 

method in your -fragment Code- 

} 

The onClick ( ) method has a single View parameter. This is the view 
that the user clicks on. You can use the View get Id ( ) method to find 
out which view the user clicked on, and then decide how to react. 




Code Magnets 



See if you can complete the 
StopwatchFragment onClick ( ) 
method. You need to call the 
onClickStart ( ) method when the Start 
button is clicked, the onClickStop ( ) 
method when the Stop button is clicked, and 
the onClickReset ( ) method when the 




©Override 

public void onClick (View v) { 

switch ( ) { 

case R. id. start_button : 

onClickStart ( ) ; 

break; 

case R. id. stop_button : 

( ) ; 

break; 

case R. id. reset button: 
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/{ t^ * 



Cocte Magnets Solution 

See if you can complete the 
StopwatchFragment onClick ( ) 
method. You need to call the 
onClickStart ( ) method when the Start 
button is clicked, the onClickStop ( ) 
method when the Stop button is clicked, and 
the onClickReset ( ) method when the 
Reset button is clicked. 




use 




didn't need to 
these magnets. 



QOverride 

public void onClick(View v) { 



switch ( 



Q, 




getld() { 



case R. id. start button: 



El 



onClickStart ( 
break; 

case R. id. stop_button : 




break; 

case R. id. reset button: 



El 



onClickReset 






) ; 



) ; 



The StopwatchFragment owClickO method 



Here’s the code to implement the StopwatchFragment 
onClick ( ) method so that the correct method gets called when 
each button is clicked: 



g Over ride / 'This is the View the usev clicked on. 

public void onClick (View v) { 

switch (v.getld() ) { Check which i/iew was clicked- 

case R. id. start_button: 
onClickStart (v) ; 
break ; 



|-f tbe Stavt button was £.litked> 
call -the onCliekStav-tO method- 



case R. id. stop-button: ^e Stop button was clicked, 

onClickStop (v) ; Call the onCliekStopO method- 

break ; 

case R. id. reset_button : ^ — |«f tbe Reset button was ditked, 
onClickReset (v) ; tall the onClitkReset^ method- 

break ; 



} 



} 



There’s just one more thing we need to do: we need to attach the 
listener to the buttons in the fragment. 
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Attach the OnClicklistener to the buttons 



To make the views respond to clicks, you need to call 
each view’s setOnClickListener () method. 

The setOnClickListener () method takes 
an OnClickListener object as a parameter. As 
StopwatchFragment implements the OnClickListener 
interface, we can use this to pass the fragment as the 
OnClickListener. 



As an example, here’s how you attach the OnClickListener to 
the Start button: 



a reference *to *tbe button. 

I 



Button startButton = (Button) layout . findViewByld (R. id. start_button) ; 
startButton. setOnClickListener (this) ; Attadh the listener to the button. 



The call to each view’s setOnClickListener ( ) method 
needs to be made after the fragment’s views have been created. 
This means they need to go in the StopwatchFragment 
onCreateView ( ) method like this: 



QOverride 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 

View layout = inf later . inf late (R . layout . stopwatch, container, false); 
runTimer (layout) ; 

Button startButton = (Button) layout . findViewByld (R. id. start_button) ; 
startButton. setOnClickListener (this) ; 

Button stopButton = (Button) layout . findViewByld (R. id. stop_button) ; 
stopButton. setOnClickListener (this) ; 

Button resetButton = (Button) layout . findViewByld (R. id. reset_button) ; 
resetButton . setOnClickListener (this) ; 

return layout; ^ 

} Th,s ^dhes the listener to each ot the buttons. 



□ 

Workout 



We’ll show you the full StopwatchFragment code on the next 
page. 



Hr 3 

app/sre/main 

HU 



java 



LQ 



com. hfad. workout 

L @ 

Stopwatch 

Fragment.java 
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The StopwatchFragment code 

Here’s the revised code for StopwatchFragment.java : 

package com. hf ad. workout ; 

WicVe us'm^ C-Uss, so wc ll iw'^ov*‘t •'t 






import android. widget . Button; 



The 'Pvajrwe^-t ^eeds -to implemeyrt 

the l/iew.OhClidkLis-tehev iirrtev-'Pade. 

public class StopwatchFragment extends Fragment implements View.OnClickListener { 

//Number of seconds displayed on the stopwatch. p 

private int seconds = 0; i | J 

//Is the stopwatch running? i x 

private boolean running; (JiSI 

private boolean wasRunning; 

WeVe not Changing the onCreateO method. 

@Override p 

public void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
if (savedlnstanceState != null) { 

seconds = savedlnstanceState . getlnt ( "seconds" ) ; 
running = savedlnstanceState . getBoolean ( "running" ) ; 
wasRunning = savedlnstanceState . getBoolean ( "wasRunning" ) 
if (wasRunning) { 
running = true; 



app/sre/main 

L a 

java 



LQ 



com. hfad. workout 

LQ 



Stopwatch 

Fragment.java 



} 



Update the onOeateVW) method to 
attach the listener to the buttons. 



@Override 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 

View layout = inf later . inf late (R . layout . stopwatch, container, false); 
runTimer (layout) ; 

Button startButton = (Button) layout . findViewByld (R. id. start_button) ; 
startButton . setOnClickListener (this) ; 

Button stopButton = (Button) layout . findViewByld (R. id. stop_button) ; 
stopButton . setOnClickListener (this) ; 

Button resetButton = (Button) layout . findViewByld (R. id. reset_button) ; 
resetButton . setOnClickListener (this) ; 

return layout; 

} 
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The StopwatchFragwent code (continued) 



@ Override 

public void onClick (View v) { ^ 
switch (v.getld()) { 

case R . id . s tart_button : 
onClickStart (v) ; 
break ; 

case R . id . s top_button : 
onClickStop (v) ; 
break ; 

case R. id. reset_button: 
onClickReset (v) ; 
break ; 

} 




public void onClickStart (View view) 
running = true; 

} 

public void onClickStop (View view) 
running = false; 

} 



/\s weVe implementing 
the OnClidkListenev- 
inter-fade, we need to 
override the onClidkO 
ethod- 



Call -the appropriate method 
in -the -fragment -for "the 
button -that was didked- 

□ 

Workout 

4a 

app/sre/main 

4U 



java 






com. hfad. workout 

LC 



Stopwatch 

Fragment.java 



■ These are -the same 
- methods that we 
^had be-fore. They II 
get called when the 
buttons are dlidked- 



public void onClickReset (View view) { 
running = false; 
seconds = 0; 



} 



Let’s see what happens when we run the app. 
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test drive 

Test drive the app 

Now when you run the app, the buttons on the stopwatch work correctly 



The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 



The Wimp Special 

5 Pull-ups 
1 0 Push-ups 
1 5 Squats 



When you dl.dk on -the Start button, 
the stopwatch starts- The Stof and 
Reset buttons u/ork as you'd e*pett too- 



0 : 00:08 



Start 

Stop 

Reset 



Put there's a problem whew you rotate the device 

If you start the stopwatch and then rotate the device, something strange 
happens. The stopwatch is reset to 0: 



The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 


The Wimp Special 

5 Pull-ups 
1 0 Push-ups 
1 5 Squats 

0 

A 


OO 

O 
■ ■ 

o 

o 
■ ■ 




1 

Start the stopwatch and 
■then rotate the device 


Start 

Stop 






Reset 




<"3 


[f=P 




The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 



The Wimp Special 

5 Pull-ups 
1 0 Push-ups 
1 5 Squats 



0:00:00 



r 

When you ro-ta-te the 
device, the stopwatch 
gets reset badk to O. 
I/Vhat^s going on? 



Stop 



Reset 



We’ve seen before that changing the screen orientation can reset the views. 
So what happens to fragments when you change the orientation? 
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Rotating the device re-creates the activity 

As you already know, when you’re running an app and 
rotate the device, the activity that’s running gets destroyed 
and re-created. All variables in the activity code are set 
back to their default values; if you want to save these values 
before the activity’s destroyed, you need to use the activity’s 
onSavelnstanceState ( ) method. 

But what if the activity contains a fragment? You’ve already 
seen that the activity and fragment lifecycles are closely related, 
but what happens to the fragment when you rotate the device? 



What happens to the fragment when you rotate the device 



© 



An activity contains a fragment. 




Activity Fragment 



O 



When the user rotates the device, the activity is 
destroyed along with the fragment. 






/ 



/ 



/ 



/ ' 



N. 



/ 



I \ 



\ 
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what happens 



The story continues... 



O 



The activity is re-created and its onCreate() method is 
called. 

The onCreate ( ) method includes a call to setContentView ( ) . 




Activity 



onCreateQ 



0 



When the activity's setContentView() method runs, it 
reads the activity's layout and replays its fragment 
transactions. 

The fragment is re-created in line with its latest transaction. 




When you rotate the device, the fragment should go back to the 
same state it was in before the device was rotated. So why, in 
our case, has the stopwatch been reset? To get some clues, let’s 
look at the WorkoutDetailFragment onCreateView ( ) 
method. 
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onCreateViewO runs AFTER the 
transactions have been replayed 



The onCreateView ( ) method runs after the activity has replayed 
all of the activity’s fragment transactions. Here’s the method. Gan 
you see why the stopwatch gets reset to 0 seconds when the device is 
rotated? 

OfiCv‘€d*tc\/iC>w0 W'C'tbod \Y\ *tbe ‘fvdgmCwt V"UKS ”tbc 

activity has replayed all o-f its -fragment transactions. 

@Override ^ 

public View onCreateView (Layoutlnf later inf later, ViewGroup container, 

Bundle savedlnstanceState) { "["^is 

if (savedlnstanceState != null) { 1/VorkoutDetailFragment 

workoutld = savedlnstanceState . getLong ( "workoutld" ) ; s ^ vc d its state prior 

to being destroyed- 



This 



k^Fragmen tT ran s action ft = getChildFragmentManager ( ) .beginTransaction () ; 



replaces the StopwatchFragment stopwatchFragment = new StopwatchFragment () ; 

stopwatch 
'fragment 
with a 
brand-new 



one- 



f t . replace (R . id . s topwatch_container , stopwatchFragment) ; 
f t . addToBackStack (null) ; 

f t . setTransition (FragmentTransaction . TRAN S I T_FRAGMENT_FADE ) ; 
ft . commit () ; 

return inf later . inf late (R . layout . f ragment_workout_detail , container, false); 



} 



The onCreateView () method includes a fragment transaction that 
replaces the stopwatch fragment with a brand-new one. This means 
that two things happen: 



o 

© 



The activity replays its fragments transactions, putting the stopwatch 
fragment in the state it was in before the device was rotated. 

The onCreateView ( ) method gets rid of the stopwatch fragment 
the activity reinstated, and replaces it with a brand-new one. As it’s a 
new version of the fragment, the stopwatch is reset to 0. 



□ 

Workout 

4U 

app/src/main 

MB 

java_ 

La 

com. hfad. workout 

LQ 



WorkoutDetail 

Fragment.java 



To stop this from happening, we need to make sure we only replace 
the fragment if the savedlnstanceState Bundle is null. This 
will mean that a brand-new StopwatchFragment is only displayed 
when the activity is first created. 
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The WorkoutPetailFragwent code 

Here’s the full code for WorkoutDetailFragment. java: 
package com. hf ad. workout; 



□ 

Workout 



Ha 

app/src/main 

HTJ 



java 



MT3 



public class WorkoutDetailFragment extends Fragment { 
private long workoutld; 



@Override 
public View 



com . hfad .workout 

L i 

WorkoutDetail 

Fragment.java 



The cwl y charge we 
1 r\tt& bo make is *to y 
f u*t *the bca*satb\oY\ s 
m an else statement 
The transaction 
will only vun i-f 
saved InstandeState 
is null- 



onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 
if (savedlnstanceState != null) { 

workoutld = savedlnstanceState . getLong ( "workoutld" ) ; 

} else { 

FragmentTransaction ft = getChildFragmentManager ( ) . beginTransaction ( ) 
StopwatchFragment stopwatchFragment = new StopwatchFragment ( ) ; 
ft . replace (R. id. stopwatch_container, stopwatchFragment) ; 
f t . addToBackStack (null ) ; 

ft . setTransition (FragmentTransaction . TRAN S I T_FRAGMENT_FADE ) ; 
ft . commit ( ) ; 



return inf later . inf late (R . layout . f ragment_workout_detail , container, false); 



@Override 

public void onStartO { 
super . onStart ( ) ; 

View view = getView(); 
if (view != null) { 

TextView title = (TextView) view. findViewByld (R. id. textTitle) ; 

Workout workout = Workout . workouts [( int) workoutld]; 
title . setText (workout . getName ( ) ) ; 

TextView description = (TextView) view . findViewByld (R . id . textDescription) ; 
description . setText (workout . getDescription ( ) ) ; 

} 

} 



QOverride 

public void onSavelnstanceState (Bundle savedlnstanceState) { 
savedlnstanceState . putLong ( "workoutld" , workoutld) ; 

} 



public void setWorkout (long id) { 
this . workoutld = id; 

} 



Let’s see what happens when we run the code. 
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Test drive the app 

Run the app, start the stopwatch, then rotate the device. Let’s 
see what happens to the stopwatch. 



it ^ Q 1 3:22 



The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 



The Wimp Special 

5 Pull-ups 
1 0 Push-ups 
1 5 Squats 



n 



0 : 00:05 

f 



Start the stopwatch and 
then rotate the device- 



Start 



Stop 



Reset 



The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 



The Wimp Special 



5 Pull-ups 
10 Push-ups 
1 5 Squats 



0 : 00:08 



f 

l/Vhen you rotate the device, 
the stopwatch keeps on 
going. Its previous state is 
maintained- 



Start 

Stop 

Reset 




The stopwatch keeps going. Even though rotating the 
device means that the activity is destroyed, the fragment 
transactions replay successfully. We’re no longer replacing 
StopwatchFragment with a brand-new fragment. 



there] are no 

Dumb Questions 



% If I use the android : onClick attribute in my 
fragment layout code, will Android really try to call a method in 
my activity? 



Yes, it will. Rather than use the android: onClick 
attribute to get views to respond to clicks, implement an 

OnClickListener instead. 



% Does this apply to nested fragments, or fragments in 
general? 



It’s common behavior with all fragments, irrespective of 
whether they’re nested inside another fragment. 




Should I use fragments in my own apps? 



^Z That depends on your app and what you want to achieve. 

One of the major benefits of using fragments is that you can use 
them to support a wide range of different screen sizes. You can, say, 
choose to display fragments side by side on tablets and on separate 
screens on smaller devices. You’ll also see some more ways in 
which using fragments can be useful in the next couple of chapters... 
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BE fjte pigment 

Below are two pieces of fragment layout 
code, and on the next page there are two 
pieces of fragment Java code. Your job 
is to play like you’re the 
fragment and say which 
combination will display a 
message when the switch in 
the layout is on. 



Q 



<LinearLayout xmlns : android="http : / / schemas . android . com/ apk/ res/ android 
xmlns : tools="http : / / schemas . android. com/ tools" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: or ientation=" vertical" 

tools : context="com . hf ad . chi 0 ex . SwitchFragment"> 



o 



<Switch 

android : id=" 0+id/ switch_view" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" /> 

</ Linear Layout> 

* P 

These are the two petes ok 

fragment layout tode 

<LinearLayout xmlns : android="http : / / schemas . android. com/ apk/ res/android 
xmlns : tools="http : / / schemas . android. com/ tools" 
android : layout_width="match_parent" 
android : layout_height="match_parent" 
android: or ientation=" vertical" 

tools : context="com. hfad. chi 0 ex . SwitchFragment"> 



<Switch 

android : id=" @+id/ switch_view" 
android : layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: onClick="onClick" /> 

</ Linear Layout> 
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public class SwitchFragment extends Fragment implements View . OnClickListener { 
@Override 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState ) { 

return inf later . inf late (R . layout . fragment_switch, container, false); 

} 

@Override 

public void onClick(View v) { 

if (v.getld() == R. id. switch_view) { 
if (((Switch) v) . isChecked ( ) ) { 

Toast .makeText (v . getContext ( ) , "On", Toast . LENGTH_SHORT) .show() ; 

} 



} 

} ^ 

These are the -two pieces of 

-Prajmen-t Java Code- 

£ 

public class SwitchFragment extends Fragment implements View . OnClickListener { 
@Override 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 

View layout = inf later . inf late (R . layout . fragment_switch, container, false); 
Switch switchView = (Switch) layout . findViewByld (R . id . switch_view) ; 
switchView . setOnClickListener ( this ) ; 
return layout; 

} 

@Override 

public void onClick(View v) { 

if (v.getld() == R . id . switch_view) { 
if (((Switch) v) . isChecked () ) { 

Toast .makeText (v . getContext ( ) , "On", Toast . LENGTH_SHORT) .show() ; 

} 



} 



} 
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BE fjte pigment yojuf/ori 

Below are two pieces of fragment layout 
code, and on the next page there are two 
pieces of fragment Java code. Your job 
is to play like you’re the 
fragment and say which 
combination will display a 
message when the switch in 
the layout is on. 



<LinearLayout xmlns : android="http : / / schemas . android . com/ apk/ res/ android" 
xmlns : tools="http : / / schemas . android. com/ tools" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: or ientation=" vertical" 

tools : context="com . hf ad . chi 0 ex . SwitchFragment"> 

, . , . , „ a , . , / . . , „ This is -the dovredt layout dode- 

android: id="@+id/switch_view" / 

android: layout_width="wrap_content" 
android: layout_height="wrap_content" /> 

</ Linear Layout> 




o 



<LinearLayout xmlns : android="http : / / schemas . android. com/ apk/ res/android" 
xmlns : tools="http : / / schemas . android. com/ tools" 
android : layout_width="match_parent" 
android : layout_height="match_parent" 
android: or ientation=" vertical" 

tools : context="com. hfad. chi 0 ex . SwitchFragment"> 



<Switch 

android : id=" @+id/ switch_view" 
android : layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: onClick="onClick" /> 

</ Linear Layout> 



The Switdh in this layout Lode uses the 
android : onClidk attribute. This will dall 
Lode in the activity, not the tra^ent- 
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o public class SwitchFragment extends Fragment implements View . OnClickListener { 



@Override 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState ) { 

return inf later . inf late (R . layout . fragment_switch, container, false); 



} 



@Override 

public void onClick(View v) { 

if (v.getld() == R. id. switch_view) { 
if (((Switch) v) . isChecked ( ) ) { 

Toast . makeText ( v . getContext ( ) , 



This Code implements \/iev/-0nClidkListeneio 
but doesn't sc* t the listener to the Sv/itdh. 
The onClidkO method never gets dalled- 

"On", Toast . LENGTH_SHORT) . show ( ) ; 



} 



} 



} 



o 



public class SwitchFragment extends Fragment implements View . OnClickListener { 



@Override 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 

View layout = inf later . inf late (R . layout . fragment_switch, container, false); 
Switch switchView = (Switch) layout . findViewByld (R . id . switch_view) ; 
switchView . setOnClickListener ( this ) ; 
return layout; 

} 



@Override 

public void onClick(View v) { 

if (v.getld() == R . id . switch_view) { 
if (((Switch) v) . isChecked () ) { 

Toast . makeText ( v . getContext ( ) , 

} 



This is -the dorredt Java Code I/Vh en the 
Switdh is dlidked, the onClidkO method runs. 

"On", Toast . LENGTH_SHORT) . show ( ) ; 



} 



} 
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You’ve got Chapter 8 under 
your belt and now you’ve 
added nested fragments to your 



Your Android Toolbox 



You tan download 
-the -full tode. -fov 
the thaftev- from 



httfs : //-t' m Y^' tom / 

tfeadFirstAndv-oid- 



toolbox. 




BULLET POINTS 



■ Fragments can contain other fragments. 

■ If you’re nesting a fragment in another fragment, you need to add the 
nested fragment programmatically in Java code. 

■ When you perform transactions on a nested fragment, use 

getChildFragmentManager ( ) to create the transaction. 

■ If you use the android: onClick attribute in a fragment, Android 
will look for a method of that name in the fragment’s parent activity. 

■ Instead of using the android : onClick attribute in a fragment, 
make the fragment implement the view . OnClickListener 
interface and implement its onClick ( ) method. 

■ When the device configuration changes, the activity and its 
fragments get destroyed. When the activity is re-created, it replays 
its fragment transactions in the onCreate ( ) method’s call to 

setContentView ( ) . 

■ The fragment’s onCreateView ( ) method runs after the activity 
has replayed its fragment transactions. 
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^ Taking Shortcuts + 




Everybody likes a shortcut. 

And in this chapter you’ll see how to add shortcuts to your apps using action bars. We’ll 
show you how to start other activities by adding action items to your action bar, how to 
share content with other apps using the share action provider, and how to navigate up 
your app’s hierarchy by implementing the action bar’s Up button. Along the way, you’ll see 
how to give your app a consistent look and feel using themes, and introduce you to the 
Android support library package. 
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app structure 



Great apps have a clear structure 

Back in Chapter 6, we looked at ways of structuring an app to 
create the best user experience. Remember that when you create 
an app, you will have three different types of screen: 




They also have great shortcuts 

if a user’s going to use your app a lot, they’ll want quick ways to 
get around. We’re going to look at navigational views that will give 
your user shortcuts around your app, providing more space in your 
app for actual content. Let’s begin by taking a closer look at the 
top-level screen in the above Pizza app. 
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(Afferent types of navigation 

In the top-level screen of the Pizza app, there’s a list of options for 
places in the app the user can go to. 




The first three options link to category activities; the first presents 
the user with a list of pizzas, the second a list of pasta, and the third 
displays a list of stores. You can think of the category activities as being 
passive. They display information and help you get around. 

The fourth option links to a detail/ edit activity that allows the user 
to create an order. This option is active. It allows the user to create 
something. 

You generally deal with active and passive navigation options in 
different ways. In this chapter, we’re going to look at how you deal with 
active navigation options. 

Using actions for navigation 

In Android apps, active navigational options are usually added to 
the action bar. The action bar is the bar you often see at the top 
of activities. It’s the place where common actions are displayed, 
so it normally includes buttons that are best described using verbs 
such as Create, Search, or Edit. 

In the Pizza app, we can make it easy for the user to place an 
order wherever they are in the app by adding an action bar to the 
top of every activity. The action bar will include a Create Order 
button so the user has access to it wherever they are. 

Let’s take a closer look at how you add action bars to your apps. 




This is a* action bav*. 



This is the Create Order button. 
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action bars and themes 



Let's start with the action bar 



The action bar has a number of uses: 



o 

o 

o 



For displaying the app or activity name so that the user knows where in 
the app they are. As an example, an email app might use it to indicate 
whether the user is in her inbox or junk folder. 

For making key actions prominent in a way that’s predictable — for 
example, sharing content or performing searches. 

For navigating to other activities to perform an action. 



To add an action bar, you need to use a theme that includes an action 
bar. A theme is a style that’s applied to an entire activity or application so 
that your app has a consistent look and feel. It controls such things as the 
color of the activity background and action bar, and the style of the text. 
Android has a number of built-in themes you can use. 

API level 11 and above 

If you want your apps to run on API level 1 1 or above, you add an action 
bar by applying Theme . Holo or one of its subclasses. This is what you’ll 
need to do most of the time. For API level 2 1 or above, you have the added 
option of using one of the newer Theme .Material themes. There are 
several different themes to choose from depending on what appearance 
you want your app to have. As an example, applying a theme of Theme . 
Material . Light . DarkActionBar will give you activities with a 
light background and a dark action bar. 









J 



Theme. 
Material. 
Light- 



API level 




7 or above These are examples o( two di*M*erent themes. 



Theme. 

ttolo. 

Light- 



If you need to support older devices running API level 7 or above, you 
can still add an action bar but you need to do it slightly differently. You 

first need to change your activities so that they extend the class android . t^e this approach 

support . v7 . app . ActionBarActivity instead of the android. Y ou *t° support older devices 

app .Activity class. You must then apply one of the Theme . running API levels 1, Q, % or lO. Most 

App Comp at themes. devices run a higher API level than this. 

The ActionBarActivity class and the Theme . AppCompat themes 
are included in the Android support libraries. Let’s look at these in 
more detail. 
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The Android support libraries 



As time passes, Android continued to add new features. But what if you 
want to use the latest Android widgets on a device that’s two or three 
years old? The Android support libraries are a set of code libraries that 
you can include in your project. They’re primarily there for backward 
compatibility, as they allow you to use newer features of Android in older 
devices. 

Some features of Android are only available in the support libraries, so 
if you need to use these features in your app, you need to use the support 
library. As an example, the Drawer Lay out APIs allow you to create a 
navigation drawer you can pull out from the side of the screen, and these 
APIs are currently only available in the v4 support library. 

The Android support library package includes several support libraries. 
Each one targets a base API level and includes a specific set of features. 
The name of the support library reflects the lowest version number 
of Android the library is compatible with. The v4 support library, for 
instance, can be used with API level 4 and higher. Similarly, the v7 support 
libraries can be used with API level 7 and higher. Each of these libraries 
undergo revisions to include new features and bug fixes. 

The classes in a support library are stored within packages named 
android . support . v*. As an example, the v4 library has classes in 
the android . support . v4 package. 

Here are some of the libraries in the Android support library package: 






Adds support for the 



v7 appcompat library [ 

Includes support for action bars on 
API level 7 and above, also creating 
and using material design. 



on 




RecyclerView 



Adds support for the 
RecyclerView widget. 



v7 cardview library 






build user interfaces for TVs. 



Android Studio will often add support libraries to your project by default. 
To see this, let’s create a new project to prototype the Pizza app and see if 
there are any references to them. 
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Your project may include support libraries 

We’re going to build a prototype of the Pizza app that supports API level 
1 7 and above. Create a new Android project with a blank activity for an 
application named “Bits and Pizzas” with a package name of 
com.hfad.bitsandpizzas . The minimum SDK should be API level 17. Specify 
an activity called “Main Activity”, a layout called “activity_main” and a 
menu resource called “menu_main”. 

We’re going to look at how your new project may be using support libraries 
by default. First, let’s look at MainActivity.] av a. Here’s the code that Android 
Studio created for us. By default, MainActivity extends the android, 
support . v7 . app . Act ionBarActivity class. In other words, it’s 
using a v7 support library: 

package com.hfad.bitsandpizzas; The ahdvoidsuppovtvT m "the 

^Aetioh&avAetivity Wpovt tells you 
K i-t's trom v7 ayytomyai library. 

import android . support . v7 . app . Ac tionBar Activity ; 



public class MainActivity extends Ac tionBar Activity { 



} 

The ActionBarActivity class is used in conjunction with the Theme . 
App Comp at themes to add action bars to apps that support API levels 
between 7 and 10. If you use the ActionBarActivity class as the 
superclass for your activities, you have to use one of these themes or your 
app won’t run. You can’t use more recent themes, such as Material. 



Vbwr Ma'mAaivi-ty.java tode »>ay 
look different. II depends Oh the 
behavior of -the IDE you're usmg. 



Even if you remove references to ActionBarActivity from your app, 
the v7 support library may still be a dependency in your project. You can 
see this by going to File— ^Project Structure. When you click on the app 
module and choose Dependencies, you may find there’s a reference to the 
v7 appeompat library: 



Ahdvoid Studio automatically added 
the v7 appeompat libvavy as a 
dependehCy. Depehdih$ oh which 
vevsioh of /Wvoid Studio you ve 
usihfy you may OV may hot have this. 



eoo 



Project Structure 



+ - 

SDK Location 
Project 

— Modules — 



Properties Signing Flavors Bui Lcl Types 



Dependencies 



{d Sr = lib s t Jncl|ide=[ lfc .jar] } 



Scope 



Compile 



(jfl com.an.cfroitf.supportL.appcompat-v7:Z 3L0.£^) Compile 
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Well get the app to use up to date themes 



We want our prototype app to include action bars. The app supports 
devices running a minimum of API level 17, so we don’t need to 
provide backward compatibility by using ActionBarActivity 
and Theme . AppCompat. Instead, we’ll bring the look more up 
to date by using a Holo theme by default, and get it to switch to a 
Material theme if it’s running on API level 2 1 . 



To do this, we need to do two things: 



© 

o 



Make sure the activity code doesn't reference ActionBarActivity. 

If it does, we’ll only be able to use a Theme . AppCompat theme. 

Apply the themes. 

We’ll get the app to pick up the right theme for the API level it’s running on. 



We’re going to keep the dependency on the v7 appcompat library as 
this has an impact on the code you’ll write later on. 

Change MainActivity to use aw Activity 

We’ll start by making sure that MoinActivity.java uses the Activity 
class and not ActionBarActivity. Update your code so that it 
looks like the code below: 



package com.hfad.bitsandpizzas; 

import android . app . Activity ; ^ 
import android . os . Bundle ; 

public class MainActivity extends 



Make sure you*- adtivity e*tends Activity, yt 
At-tionBarMwi-ty. It y ow wse AdWBarAdly-ty, 
you dan't use ike Holo o*- Maternal tken.es, A«dro.d 
lovdes you to use an AffCornfai tken>e- 



Activity { 



□ 






@ Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_main) ; 



Hn 

app/src/main 

MB 

java_ 



} 

} 

Now that we know MainActivity doesn’t use 
ActionBarActivity, we’ll look at how you apply a theme. 



com.hfad.bitsandpizzas 



MainActivity.java 
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Apply a theme in Android Manife$t.xml 

As you’ve already seen, the app’s AndroidManifest.xml file provides essential 
information about the app such as what activities it contains. It also includes a 
number of attributes that have an impact on your action bars. 

Here’s the AndroidManifest.xml code Android Studio created for us (we’ve 
highlighted the key areas): 



□ 

BitsAndPizzas 




AndroidManifest.xml 



<manif est xmlns : android="http : / / schemas . android . com/ apk/ res/ android" 
package="com. hfad. bitsandpizzas" > 

application Ue > |ton . Android Studio 

android: allowBackup="true" ^ ^ ^ de {3ult 

android : icon=" @mipmap/ic_launcher" ^ ' 

android: Iabel="0string/app_name" ^ — User— -friendly n<3me o-f the 3pj> 
android: theme="@ style /AppTheme" >^— theme 

<activity 

android: name=" . MainActivity" 0 . 

android: lab e l="0string/app_nam e " > ^ ^--friendly <* adt,Vrt V 



</ activity> 
</ application> 
</manifest> 



The label 
The icon 




The android: icon attribute is used to assign an icon to the app. The icon is 
used as the launcher icon for the app, and if the theme you’re using displays an 
icon in the action bar, it will use this icon. 



The icon can be a drawable or mipmap resource. A mipmap is an image that 
can be used for application icons, and they’re held in mipmap* folders in app/src/ 
main/res . Just as with drawables, you can add different images for different screen 
densities by adding them to an appropriately named mipmap folder. As an example, 
an icon in the mipmap-hdpi folder will be used by devices with high-density screens. 
You refer to mipmap resources in your layout using @ mipmap . 

The android : label attribute assigns a user-friendly label to the app or activity, 
depending on whether it’s used in the <application> or <activity> 
attribute. The action bar displays the current activity’s label. If the current 
activity has no label, it uses the app’s label instead. 



— * Android Studio creates 

default application icons -fov 
you -for different screen 
densities Older versions of 
Android Studio put tbe icons 
in tbe drawable -folders, and 
newer versions put them in 
tbe mipmap -folders. 



The android : theme attribute specifies the theme. Using this attribute in 
the <application> element applies it to the entire app. Using it in the 
<activity> element applies it to a single activity. 



Our android: theme attribute has the value n @style/AppTheme". The 
@ style prefix means that the theme is defined in a style resource file. So 
what’s a style resource file? 
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Refine styles in style resource files 



A style resource file holds details of any themes you want to use. 



When you create a project in Android Studio, the IDE creates a default 
style resource file for you called styles. xml located in the app/src /main/res/ 
values folder. It will look something like this: 

<resources> 

<!-- Base application theme. --> 



por/'t wovvy i-f f[v\dro\d Studio ^ 
has used a different theme-we'll 
/ change it on the ne*t pa^e- 



<style name=" AppTheme" parent=" Theme .AppCompat . Light . DarkActionBar M > 
<!-- Customize your theme here. --> 



</style> 



</resources> 



The style resource file contains one or more styles. Each style is defined 
using the <style> element. 

Each style must have a name, which you define with the name attribute. 
The style must have a name so that the android : theme attribute 
in AndroidManifest.xml can refer to it. In our case, the style has a name 
of "AppTheme", so AndroidManifest.xml can refer to it using " 0style/ 
AppTheme". 

The parent attribute specifies where the style should inherit its 
properties from. In the case above, this is "Theme .AppCompat . Light . 
DarkActionBar" . 

You can also use the style resource file to customize the look of your app 
by modifying the properties of an existing theme. To do this, you add an 
<item> element to the <style> that describes the modification you 
want to make. As an example, here’s how you’d modify the theme so that 
all the activities have a red background: 



□ 

BitsAndPizzas 

HH 

app/src/main 




values 




styles.xml 



<resources> 

<style name= "AppTheme" parent= "Theme .AppCompat . Light . DarkActionBar "> 
<i tern name= " android : background" >#FF0 0 0 0< / i tem> 

A 



</style> 
</ resources> 



This line -turns the backgrounds 
or your activities red- 



We’re not going to go into detail about customizing themes here. If 
you want to learn more we suggest you look at the online reference 
documentation: http:/ / developer, android, com/guide/ topics/ ui/ themes. html. 

On the next page, we’re going to change the theme used by the app. 
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Set the default theme in styles.xml 



We’re going to change the app so that it uses Theme .Holo. Light 
by default, and switches to using Theme . Material . Light if the 
app’s running on API level 2 1 . 



We’ll start by changing the default theme. To do this, open the style 
resource file styles.xml located in the app /src /main /res /values folder. This 
is the default style resource file. By default, we want to use a theme of 
Theme . Holo . Light, so this needs to be reflected in the <style> 
attribute like this: 

<resources> 



□ 

BitsAndPizzas 

4ia 



<style name="AppTheme" parent="android: Theme . Holo . Light"> 

<!-- Customize your theme here. --> 

</ style> 

</ resources> 



app/src/main 

4^ 



values 




Use a Material theme on newer devices 




styles.xml 



As you saw in Chapter 8, you can use different folder structures to get 
your app to use different resources at runtime. As an example, you saw 
how to get your app to use different layout files depending on the size 
of the device screen. 

Here, we need the app to use a different style resource depending on 
the API level the app’s running on. To get the app to use a particular 
resource if the app’s running on API level 2 1, we can create a new 
values-v2 1 resource file and add the resource to this folder. 

To do this, create a new folder in the app /src /main/res folder called 
values-v21. Then copy the file styles.xml from the values folder, and paste 
it in the values-v21 folder. 

We want the app to use a Material theme if it’s running on API level 
2 1, so edit styles.xml in the values-v21 folder so that it uses a theme of 
Theme .Material . Light: 



/*' 

>'11 -find it easiev / 
add the new 
dev it you switdh 
the Pvojett view 
the tile e*f>lovev. 



/ BitsAndPizzas 

Project 



|E Packages 
■S' Android 

Scopes 

• Project Files 

• Problems 

• Production ldro| l 

• Tests ain 



BitsAndPizzas 



<resources> 

<style name="AppTheme" parent=" android: Theme .Material . Light" > 

<!-- Customize your theme here. --> ^ 

</ style> We|| use -this theme it the 

</ resources> 



WC II 

devide is ruirm’mj API l cvc l 



The style name we’re using in each style resource file should be the 
same, because this enables an appropriate theme to be used at runtime. 
Let’s see how. 



4a 

app/src/main 




values-v21 




styles.xml 
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What happens when you run the app 



O 



© 



When you run the app. Android sees that it needs to apply the theme 
described by ©style/AppTheme. 



£6 

rjTjO 

TT 

Android 



0 O 



I must use the style called 
AppTheme that's the best 
fit for this device. 



If the app's running on API level 21, it uses the style called AppTheme in the 
values-21 folder. 

The style specifies a theme of Theme .Material . Light, so it applies this theme. 





Android 




values-v21 




styles.xml 



Name: AppTheme 

Parent: ineme.Material.Light 



© 



If the app's running on an API level below 21, it uses the style called 
AppTheme in the values folder. 

The style specifies a theme of Theme . Holo . Light, so this theme is applied instead. 




test drive the app 



When you run the app, MainActivity has an action bar. If you 
run the app on a device that has API level 2 1 , the app uses a theme of 
Theme . Material . Light. If you run the app on a device with a 
lower API level, it uses a theme of Theme . Holo . Light. 
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Adding action items to the action bar 

Most of the time, you’ll want to add action items to the action bar. 
These are buttons or text in the action bar you can click on to make 
something happen. As an example, we’re going to add a “Create 
Order” button to our action bar. 




VVcMl dveate a new 
Create Ov-dcv" action 
button- 



To add action items to the action bar, you do three things: 



o 

© 

© 



Define the action items in a menu resource file. 

Set the activity to inflate the menu resource. 

You do this by implementing the onCreateOpt ions Menu ( ) method. 

Add code to say what each item should do when clicked. 

You do this by implementing the onOptionsItemSelected ( ) 
method. 



We’ll start with the menu resource file. 



376 Chapter 9 




action bars 



The menu resource file 

When you create a project containing an activity, Android Studio creates 
a default menu resource file for you. We told Android Studio to call this 
file menu_main.xml , and it created it in the app/src /main /res /menu folder. All 
menu resource files go in this folder. 

Here’s the menu resource file Android Studio created for us. It describes a 
single Settings action item that appears in the action bar overflow: 



Owv default action bar. 




<menu xmlns : android="http : / / schemas . android . com/ apk/ res/ android" 
xmlns : tools="http : / / schemas . android. com/ tools" 
xmlns : app="http : / / schemas . android. com/ apk/ res-auto" 
tools : context=" . MainActivity"> 



□ 



BitsAndPizzas 



<item android: id="@+id/ action_settings" 

This is the ^ android : title=" @ string/ action_settings " 

Settings android: order InCategory=" 100" 

app : showAsAction="never" /> 



413 

app/sre/main 



m3 



CO 

m3 



</menu> 

Each menu resource file has a <menu> element at its root. A menu 
resource file defines a single menu, or set of items to be added to the action 
bar. Your app can contain multiple resource files, and this is useful if you 
want different activities to have different items on their action bars. 



menu 




menu_main.xml 



Items are added to the menu using the <item> element. Each action item 
is described using a separate <item>. The <item> element has a number 
of attributes you can use, here are some of the most common ones: 



androidiid 


Gives the item a unique ID. You need this in order to 
refer to the item in your activity code. 


android:icon 


The item’s icon. This is a drawable or mipmap resource. 


androidititle 


The item’s text. This may not get displayed if your item 
has an icon if there’s not space in the action bar for both. 
If the item appears in the action bar’s overflow, only the 
text will be displayed. 


android: or derlnCategory 


An integer value that helps Android decide the order in 
which items should appear in the action bar. 



The code above uses another attribute, showAsAction. We’ll look at this 
on the next page. 
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The menu showAsAction attribute 



The showAsAction attribute is used to say how you want the 
item to appear in the action bar. As an example, you can use it to 
get an item to appear in the overflow rather than the main action 
bar, or to place an item on the main action bar only if there’s room. 
The attribute can take the following values: 



"ifRoom" 

"withText" 



Place the item in the action bar if there’s space. If there’s not 
space, put it in the overflow. 

Include the item’s title text. 



"never" 



Put the item in the overflow area, and never in the main action bar. 



"always" 



Always place the item in the main area of the action bar. This 
value should be used sparingly; if you apply this to many items, 
they may overlap each other. 



Let’s look again at the showAsAction attribute in the menu 
resource code. Notice how the showAsAction attribute is 
prefixed with app : not android : 

<menu xmlns : android="http : / / schemas . android. com/ apk/ res/android" 

xmlns :app= M http: //schemas .android.com/apk/res-auto" adds nafnespate- 

. . . > 



<item android: id="@+id/action_settings" IP) title, and ovdev-IttCate^ovy 

android: title="@string/ action_settings"^5^ attributes use tbe android namespace- 
android: orderInCategory="100" ^ 

app: showAsAction="never" /> <— sbowAsAction uses tbe app namespace. 

</menu> 

Earlier in the chapter, you saw how our project had a dependency 
on the v7 appcompat library. The v7 appcompat library doesn’t 
include showAsAction in the android namespace. 

If your project has a dependency on the v7 appcompat library , 
showAsAction must be prefixed with app : , and the <menu> 
element must include an attribute of 

xmlns : app="http : / / schemas . android . com/ apk/ res-auto 

If your project has no dependency on the v7 appcompat library , 
showAsAction must be prefixed with android : , not app : . menu_main.xml 

You can also omit the attribute 

xmlns : app="http : / / schemas . android. com/ apk/ res-auto" 
from the <menu> element. 



□ 

BitsAndPizzas 

4TJ 

app/src/main 

HH 

res 
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Add a new action item 



We’re going to add a new item to the action bar for creating orders. The item 
will have a title of “Create Order” and an icon. 

When you use icons in your action bar, you can create your own or use 
icons from the Android action bar icon pack. The icon pack contains many 
standard icons you can use in your apps. 

We’re going to use the ic_action_new_event icon from the icon 
pack. First, download the icon pack from https://developer.android.com/design/ 
downloadsAndex.html. If you expand it, you’ll see there are many different icons 
for different themes and screen sizes. 




The ic_action_new_event icons are located in th e Action Bar Icons/ 
holo_light/05_content_new_event folder. There are different icons for different 
screen sizes, indicated by their folder name. You need to copy the icons to 
appropriate folders in your project. Copy the icon in the drawable-hdpi folder to 
the drawable_hdpi folder in your project, and so on. 

Once you’ve added the icons, add a new action_create_order string 
resource to strings, xml: 



|.f Android Studio hasn t treated 
the -folders -for you, you II need to 
Create the™ yourself • 



<string name= M action_create_order M >Create Order</string> ^ — Wei! use this -for the 

.. . , , ,, iWs title. 

I hen add the menu item to menu_main.xmt : 



<menu xmlns : android="http : / / schemas . android. com/ apk/ res/android 
xmlns : too ls=" http : / / schemas . android . com/ tools" 
xmlns : app="http : / / schemas . android . com/ apk/ res-auto" 
tools : context=" . MainActivity"> 



II 




BitsAndPizzas 



<item android : id=" @+id/action_create_order " 

android: title="@string/action_create_order" 
android: icon= M 0drawable/ic action new event" 

'Y~ 

SThe 

the aeti 



HS 

app/src/main 



android : order InCategory=" 1 " 
app : showAsAction=" if Room" /> 



L Q 

res 

new ite™ is displayed as an i£on on MZ3 

action bar i-f there s room -for it- menu 



<item android: id="@+id/ action_settings" 

android: title="0string/ action_settings" 
android: orderInCategory=" 100 " 
app : showAsAction="never" /> 




menu_main.xml 



</menu> 



Now that you’ve added action items to the menu resource file, you need to 
add the items to your action bar in your activity code. Let’s see how. 
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Inflate the menu in the activity with 
the onCreateOptionsMenuO method 

Once you’ve created a menu resource file, you add the items 
it contains to the action bar by implementing the activity’s 
onCreateOptionsMenu ( ) method. It runs when the action 
bar’s menu gets created and takes one parameter, a Menu object 
representing the action bar. 

Here’s our onCreateOptionsMenu ( ) method: 



package com. hfad. bitsandpizzas; 

import android . view . Menu ; The onCrea-teOp-ticmsMenuO 

•^c-thod uses -the Menu dass. 

public class MainActivity extends Activity { 



□ 

BitsAndPizzas 

HU 

app/sre/main 

HU 

java_ 

HU 



com. I 

UyUentino> "this method adds any iW in 
the menu vesouv-te tile to the action bar- 

@ Override 

public boolean onCreateOptionsMenu (Menu menu) { 

// Inflate the menu; this adds items to the action bar if it is present. 
getMenuInf later ( ) . inflate (R . menu . menujnain , menu) ; 
return super . onCreateOptionsMenu (menu) ; 



LfS IZZaS 

If) 

MainActivity.java 



} 



} 



You add items to the action bar using 



^ ^This is a Menu object that 

getMenuInf later ( ) .inflate (R.menu.menu_main, menu) ; v-epreserrts "the action bar. 

This is -the menu resource -file. 



This takes the menu items in the menu_main.xml menu resource file, 
and adds them to the action bar Menu object. 
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React to action item clicks with the 
onOptionsItemSelectedO method 

You get your activity to react to when an action item in the action 
bar is clicked by implementing the onOptionsItemSelected ( ) 
method. This method runs whenever an item in the action bar is 
clicked. 

The onOptionsItemSelected ( ) method takes one attribute, 
a Menultem object that represents the item on the action bar that 
was clicked. You can use the Menu I tern’s getltemld ( ) method 
to get the ID of the item on the action bar that was clicked so that 
you can perform an appropriate action, such as starting a new 
activity. 

Here’s the code for our onOptionsItemSelected ( ) method: 



package com. hfad. bitsandpizzas; 

. .... „ >£— The onOptionsItemSeledtedO 

import android, view. Menultem ; * ... . 

method uses this dass. 



public class MainActivity extends Activity { 



□ 



BitsAndPizzas 



KU 

app/src/main 

L a 



java 



4T3 



The Menultem object is the item on 
the action bar that was disked- 

0 Override 

public boolean onOptionsItemSelected (Menultem item) { 

switch (item. getltemld () ) { . C hedc whith item was tfeked. 



com. hfad. bitsandpizzas 



Andvoid Studio 
treated a Set-tiny 
item tor us. You'd - 
put tode to get 
it to do something 
here 

} 

} 



MainActivity.java 



case R . id . action_create_order : 

//Code to run when the Create Order item is clicked 
return true; 

case R. id. action_settings : 

//Code to run when the settings item is clicked 

return true; ^ ReW ^rue ^||s Android you've dealt with the item being dlitked- 
default: 

return super . onOptionsItemSelected (item) ; 



T 



We need to get the Create Order item to do something. 



We’re going to get the Create Order action item to start a new 
activity called OrderActivity when it’s clicked. 
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Create OrderActivity 

We need to create a new activity called OrderActivity so our 
Create Order action item can launch it. 

Start by creating a new blank activity Give it a name of 
“OrderActivity”, a layout name of “activity_order”, a title of 
“Create Order”, and a menu resource name of “menu_order”. 

Here’s the code for OrderActivity.] av a. Make sure that your code 
reflects ours. In particular, make sure that OrderActivity 
extends the Activity class and not ActionBarActivity. 
This is because you can only use one of the Theme . AppCompat 
themes with ActionBarActivity, and we want to use the 
Holo and Material themes . 

package com.hfad.bitsandpizzas; 



- Make svire that Ov-der Activity 
e*Ws Adtivi-ty, not 
A d’tionBav-Ad'tivi'ty- □ 

V BitsAndPizzas 

public class OrderActivity extends Activity { L n 



import android . app . Activity ; 

import android . os . Bundle ; 



QOverride 

protected void onCreate (Bundle savedlnstanceState) 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_order ) ; 



} 



app/sre/main 

HT3 



java 



LQ 



com.hfad.bitsandpizzas 

L @ 

O rd e r Ac ti v i ty.j a va 



We’ve not included the onCreateOptionsMenu ( ) 
and onOptionsItemSelected ( ) methods in our 
OrderActivity code, as we don’t need OrderActivity to 
display menu items from the menu resource file in its action bar. 
These methods would need to be added if we ever did want to 
display menu items. 

Now that we’ve created OrderActivity, let’s get the Create 
Order action item in MainActivity to start it. 
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Start OrderActivity with the 
Create Order action item 



We want to get the Create Order action item in the MainActivity 
action bar to start OrderActivity when it’s clicked. To do this, we 
need to update MainActivity’s onOptionsItemSelected ( ) 
method. We’ll start OrderActivity using an intent. 

Here’s the code we need to change: 

package com.hfad.bitsandpizzas; 



import android, content. Intent; * eec * uSe 6 ' 3SS 



□ 



BitsAndPizzas 



public class MainActivity extends Activity { 



4a 

app/src/main 

T3 



java 



43 



QOverride 

public boolean onOptionsItemSelected (Menultem item) { 
switch (item. getltemld () ) { 

case R. id . action_create_order : 

//Code to run when the Create Order item is clicked 

Intent intent = new Intent (this , OrderActivity . class) ; 
startActivity (intent) ; k This 1S US ed to start 

return true; 

case R . id . action_set tings : 

//Code to run when the settings item is clicked 
return true; 
default : 

return super . onOptionsItemSelected (item) ; 



com.hfad.bitsandpizzas 

L 0 

MainActivity.java 



OrderActivity when the Create 
Order action "item is dlidked- 



} 



When the Create Order action item is clicked, it will create an intent that 
starts OrderActivity. 

We’ll show you the full MainActivity.java code on the next page. 
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The full MainActivity .java code 



package com.hfad.bitsandpizzas; 

import android. app .Activity; 
import android. content . Intent; 
import android . os . Bundle ; 
import android. view. Menu; 
import android. view. Menultem; 



□ 

Bits And Pizzas 

4Z3 

app/src/main 

java_^ 

M3 



public class MainActivity extends Activity { 



©Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_main) ; 



com . hfad . bitsand pizzas 

L@ 

MainActivity.java 



} 

Add ilems -to -the ac.W hav. 

SOverride 

public boolean onCreateOptionsMenu (Menu menu) { 

// Inflate the menu; this adds items to the action bar if it is present. 
getMenuInf later ( ) . inf late (R . menu . menu_main, menu); 
return super . onCreateOptionsMenu (menu) ; 

} 



©Override 

public boolean onOptionsItemSelected (Menultem item) { 
switch (item. getltemld ( ) ) { 

case R. id. action_create_order : 

//Code to run when the Create Order item is clicked 
Intent intent = new Intent (this, OrderActivity . class ) ; 
startActivity (intent) ; 

return true; stavt OrdcrMi ivi-fcy whch the 

case R. id. action settings : Create 0\rde\r item is dlidked- 

//Code to run when the settings item is clicked 
return true; 
default : 

return super . onOptionsItemSelected ( item) ; 

} 
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Test drive the app 

When you run the app, a new Create Order action item is 
displayed in the MainActivity action bar. When you click 
on the action item, it starts OrderActivity. 



Bits And Pizzas 



Hello world! 




ttevVs -the Create 
Order afrticm item 




Don’t worry if your 
action item doesn’t 
appear in the main 
action bar. 

The action item may appear in the 
overflow instead. This is due to a bug 
in some revisions of the v7 appcompat 
library. If this is a problem in your app, 
report it to Google. 



Order Activity 



Hello world! 



\ 



Clicking oh the Create 
Order action ite m 
stav-fcs Ov-devAfrtivi-fcy. 




iheve-iwce no 

Dumb Questions 



My app already includes a label 
and icon. Where did they come from? 



^Z When you create an Android project 
using an IDE like Android Studio, the IDE 
creates a bunch of code for you. This 
includes things such as the app label and 
icon. 



Q? Can you use action bars if you 
want to support an API below level 7? 



^Z No, you can’t. This isn’t that big a 
deal, though, because very few devices run 
API level 7 or below. 




do I have to use 



Ac tionBar Activity if I want to 
support an API below level 11? 



Z You have to use the Android support 
library to add an action bar in this case. 



% Would I ever want to use different 
themes for different API levels? 



Z You might. Material was introduced 
with API level 21 , so you might want apps 
to use this theme if it’s available. 



You say you can apply themes to 
activities individually. Would I ever want 
to do that? 



Z Yes, you might. The Holo and 
Material themes have several subclasses 
of themes that give activities a slightly 
different appearance. If you want to give 
one of your activities a different look, you 
might want it to use a different theme. 
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Sharing content on the action bar 



The next thing we’ll look at is how to use an action provider with 
your action bar. An action provider is an item you add to your 
action bar that handles its own appearance and behavior. 

We’re going to concentrate on using the share action provider. The 
share action provider allows users to share content in your app with 
other apps such as Gmail. As an example, you could use it to let 
users send details of a particular pizza to one of their contacts. 

The share action provider defines its own icon, so you don’t have to 
add it yourself. When you click on it, it provides you with a list of 
apps you can use to share content. 

You share the content with an intent 

To get the share action provider to share content, you pass it an 
intent. The intent you pass it defines the content you want to share, 
and its type. As an example, if you define an intent that passes text 
with an ACTION_SEND action, the share action will offer you a list 
of apps on your device that are capable of sharing this type of data. 



This is wha-t the share adtio* looks 
like on the attion bar. When you 
dlitk on it, it 5'res you a list o+ 
apps that you tan use to share 
to ntent- 




© 



Your activity creates an intent and passes it to the share action provider. 

The intent describes the content that needs to be shared, its type, and an action. 




YourActivity 



Intent 



ACTION_SEND 
type: "text/plain" 
messageTextf'Hi!" 




ShareAction 

Provider 



© 



When the user clicks on the share action, the share action uses the intent 
to present the user with a list of apps that can deal with it. 

The user chooses an app, and the share action provider passes the intent to the app’s activity 
that can handle it. 



o 



ShareAction 

Provider 



Intent 




ACTION_SEND 
type: "text/plain" 
messageText:"Hi!" 



AppActivity 
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Add a share action provider to menu_main.xml 



You add a share action to the action bar by including it in the 
menu resource file. 



To start, add a new action_share string to strings.xml. We’ll 
use it to add a title to the share action in case it appears in the 
overflow: 

<s tr ing name= " ac tion_share " >Share</ s tr ing> 

You add the share action to the menu resource file using the 
<item> element as before. This time, however, you need to 
specify that you’re using a share action provider. You do this by 
adding an attribute of android: actionProviderClass 
and setting it to android . widget . ShareActionProvider. 

Here’s the code to add the share action: 



□ 

BitsAndPizzas 

4 n 

app/src/main 




values 




strings.xml 



<menu xmlns : android="http : / / schemas . android. com/ apk/ res/android 
xmlns : app="http : / / schemas . android . com/ apk/ res-auto" 



xmlns : too ls=" http : / / schemas . android . com/ tools" 
tools : context=" . MainActivity"> 

<item android : id=" @+id/ action_create_order " 

. . . /> 



□ 



BitsAndPizzas 



Hr 

app/src/main 
1 ■ 



res 



m3 



<item android: id="@+id/action_share" 

android : ti tle= M @ s tring/ac tion_share " 

android: orderInCategory="2" p is? | a y ^he s h a v- e action provider 

in the action bar it there's room. 



menujnain.xml 



app : showAsAction= M if Room" ^ 
android: actionProviderClass=" android. widget . ShareActionProvider" /> 

This is shave action Pvovidcv elass 

<item android: id="@+id/action_settings" ' d 

. . . /> 

</menu> 



When you add a share action to your menu resource file, 
there’s no need to include an icon. The share action provider 
already defines one. 



Now that we’ve added the share action to the action bar, let’s 
specify what content to share. 
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Specify the content with an intent 

To get the share action to share content when it’s clicked, you need 
to tell it what to share in your activity code. You do this by passing 
the share action provider an intent using its setSharelntent () 
method. Here’s how you’d get the share action to share some default 
text when it’s clicked: 



package com. hfad.bitsandpizzas; 



import android . widget . ShareActionProvider ; 

public class MainActivity extends Activity { 



□ 

BitsAndPizzas 

HU 

app/src/main 

L Q 

java_ 

HZ3 



private ShareActionProvider ShareActionProvider; com. hfad.bitsandpizzas 

t L @ 

Add a ShareActionProvider private MainActivity.java 

@Override variable- 

public boolean onCreateOptionsMenu (Menu menu) { 

getMenuInf later ( ) . inf late (R. menu .menu_main, menu) ; 

Menultem menultem = menu. findItem(R. id. action_share) ; 

ShareActionProvider = (ShareActionProvider) menultem. getActionProvider () ; 

setlntent ( "This is example text") ; VV z ± r in , 

qct a re-reren£e to the share action provider 

return super . onCreateOptionsMenu (menu) ; ^ ^ ^ ^ ^ ^ 



} 



Call "the setlntentO rwe'thod- 



private void setlntent (String text) { 

Intent intent = new Intent (Intent . ACTION_SEND) ; 

intent. setType <" text/plain") ; ^ ^ ^ we -t hod- 

intent . putExtra ( Intent . EXTRA TEXT , text) ; ^ tv . ea ^ es a „ mWt, passes rt 

ShareActionProvider . setSharelntent (intent) ; share action provider 

} its setSharelntentO method- 



You need to call the share action provider’s setSharelntent () 
method whenever the content you wish to share has changed. As an 
example, if you’re flicking through images in a photo app, you need to 
make sure you share the current photo. 

We’ll show you our full activity code on the next page, and then we’ll 
see what happens when the app runs. 
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The full MainActivity.java code 



Here’s the full activity code for MainActivity.java : 



package com. hfad.bitsandpizzas; 



□ 



Bits And Pizzas 



import android . app . Activity; 

import android. content . Intent; 

import android . os . Bundle ; 

import android. view. Menu; 

import android . view . Menultem; 

import android . widget . ShareActionProvider ; 



HT3 



app/src/main 



H3 



tVeVe us'm$ “the 



java 



LQ 




com . hfad . bitsand pizzas 




public class MainActivity extends Activity { 



MainActivity.java 



private ShareActionProvider ShareActionProvider ; 

@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_main) ; 



public boolean onCreateOptionsMenu (Menu menu) { 

// Inflate the menu; this adds items to the action bar if it is present. 
getMenuInf later ( ) . inf late (R. menu .menu_main, menu) ; 

Menultem menultem = menu, findl tern (R. id. action_share) ; 

ShareActionProvider = (ShareActionProvider) menultem. getActionProvider () ; 
setlntent ( "This is example text") ; 

return super . onCreateOptionsMenu (irm~ in x ^ 



private void setlntent (String text) { 

Intent intent = new Intent (Intent .ACTIONJSEND) ; 
intent . setType ("text/plain") ; 
intent . putExtra ( Intent . EXTRA_TEXT , text) ; 
ShareActionProvider . setSharelntent (intent) ; 



@Override 




} 
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The MainActiviiy.java code (continued) 



□ 



Bits And Pizzas 



@Override 

public boolean onOptionsItemSelected (Menultem item) { 
switch (item. getltemld ( ) ) { 

case R. id. action_create_order : 

//Code to run when the Create Order item is clicked 
Intent intent = new Intent (this, OrderActivity . class ) ; 
startActivity (intent) ; 
return true; 

case R . id . action_settings : 

//Code to run when the settings item is clicked 



4D 

app/src/main 

Kn 



java 



LQ 



com. hfad.bitsand pizzas 



MainActivity.java 



return true; 
default : 

return super . onOptionsItemSelected ( item) ; 



This method bdsn *t fi-ban^cd- 



} 



Test drive the app 

Remember, -the share action may appear 
in -the action bar over-flow ins-tea d o-P 
on -the main area o-P -the action bar. 



When you run the app, the share action is displayed in the 
action bar. When you click on it, it gives you a list of apps to 
choose from that can accept the intent we want to share. When 
you choose an app, it shares the default text. 



Bits And Pizzas 




Hello world! 

The intent we passed 
to -the shave action 
pvovidev says we want 
to shave tent using 
ACTI0N_S£ND. It 
displays a list of apps 
that can do this. 




When you choose an app, 
it shaves the default text- 
ile Chose the Messaging 
app on ouv device, so it's 
used the text as the 
body of a message- 

t 

This is example text 
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Enabling Up navigation 



This is tVie Up WtW 



If you have an app that contains a hierarchy of activities, you can 
enable the Up button on the action bar to navigate through the app 
using hierarchical relationships. As an example, MainActivity 
in our app includes an action item on its action bar that starts a 
second activity, Order Activity. If we enable the Up button on 
Order Activity’s action bar, the user will be able to return to 
MainActivity by clicking on it. 





Up navigation may sound the same as using the Back button, but 
it’s different. The Back button allows users to work their way back 
through the history of activities they’ve been to. The Up button, on 
the other hand, is purely based on the app’s hierarchical structure. 



The pareh-fc a^fcivi-fcy 






The £hild a^iivi-ty. 

Clifcki*3 OY\ -the child’s 
Up button will -take you ^ 
up “the hievav-dhy “to "the 
activity s pav-ent 




Use the Back button 
to navigate hack to 
the previous activity. 

Use the Up button to 
navigate up the app’s 
hierarchy. 



So that you can see this in action, we’re going to enable the Up 
button on Order Activity’s action bar. When you click on it, it 
will display MainActivity. 
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Setting an activity's parent 

The Up button enables the user to navigate up a hierarchy of activities 
in the app. You declare this hierarchy in AndroidManifest.xml by specifying 
the parent of each activity As an example, we want the user to be able 
to navigate from OrderActivity to MainActivity when they 
press the Up button, so this means that MainActivity is the parent of 
OrderActivity 

From API level 1 6, you specify the parent activity using the 
android : parentActivityName attribute. For older versions of 
Android, you need to include a <meta-data> element that includes 
the name of the parent activity Here are both approaches in our 
AndroidManifest. xml : 

<?xml version="1.0" encoding="utf-8 " ?> 

Cmanifest xmlns : android="http : / / schemas . android . com/ apk/ res/android" 
package="com. hf ad.bitsandpizzas" > 

Application 

android : allowBackup="true" 
android : icon=" @mipmap/ ic_launcher " 
android : label=" ©string/ app_name" 
android : theme=" ©style/AppTheme" > 

Activity 

android : name=" .MainActivity" 
android : label=" ©string/ app_name" > 

<intent-f ilter> 

Action android: name="android. intent . action .MAIN" /> 
<category android : name="android . intent . category . LAUNCHER" /> 
</ intent-f ilter> 

</ activity> 



□ 

BitsAndPizzas 




AndroidManifest.xml 



Activity 

android: name=" . OrderActivity" ^ ^ ^ ^ us£ ft* 

android: label=" 0 string/ title_activity_order" ^ ^ 0v-dev-Attivity's 

android : parentActivityNaine = " . MainActivity" ^ 

<meta-data 

android : name=" android . support . PARENT_ACTIVITY" 
android: value=" .MainActivity" /> 



* imw i v/ i w 

parent is MamA^-bWrbY* 



</ activity> 

</ application> 

</manifest> 

Finally, we need to enable the Up button in OrderActivity. 



^ o«ly «eed b> add the <^eia-daia> 
element i-f youVe supporting apps below API 
level It. IVe ve only included it so you dan see 
what it looks like, a*d ihdudihg it doesr/t do 
a*y hairm. 
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Adding the Up button 

You enable the Up button from within your activity code. 
You first get a reference to the action bar using the activity’s 
getActionBar ( ) method. You then call the action bar’s 
setDisplayHomeAsUpEnabled ( ) method, passing it a 
value of true. 



Watch it! 



If you enable the 
Up button for an 
activity, you must 
specify its parent. 



ActionBar actionBar = getActionBar () ; 
actionBar . setDisplayHomeAsUpEnabled (true) ; 

We want to enable the Up button in Order Activity, so we’ll 
add the code to the onCreate ( ) method in OrderActivity.java. 
Here’s our full activity code: 



If you don’t , 
you’ll get a null pointer 
exception when you call the 
setDisplayHomeAsUpEnabled() 
method. 



package com.hfad.bitsandpizzas; 



. WeVe us'm^ -the Mti onBav 

import android. app. ActionBar; t | asSj so we nee( l {# impov-t 

import android. app .Activity; 
import android. os . Bundle; 

public class OrderActivity extends Activity { 
@Override 

protected void onCreate (Bundle savedlnstanceState 
super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_order ) ; 

ActionBar actionBar = getActionBar () ; 
actionBar . setDisplayHomeAsUpEnabled (true) ; 



it 



□ 

BitsAndPizzas 

HU 



app/src/main 
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java_ 
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com.hfad.bitsandpizzas 



OrderActivity.java 



} 



} 






This Cables the Up button 

in the action bav*. 



Let’s see what happens when we run the app. 
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Test drive the app 

When you run your app and click on the Create Order action 
item, Order Activity is displayed as before. 
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Your Android Toolbox 

You’ve got Chapter 9 under 
your belt and now you’ve 
added action bars to your 
toolbox. 



You ta* download 
-the -full tode &>r 
the tKaftev- -fvom 

V)UfS://tmYuV-Uom/ 

HeadFivstAridv-oid- 




BULLET POINTS 



■ To add an action bar to apps supporting API 
level 11 or above apply one of the Holo or 
Material themes. 

■ Add an action bar to apps supporting 
API level 7 or above by applying an 
AppCompat theme and using the 

ActionBarActivity class. If you use 
ActionBarActivity, you must use 
an AppCompat theme. 

■ ActionBarActivity and the 

AppCompat themes are in the v7 appcompat 
support library. 

■ The android : theme attribute in 
AndroidManifest.xml specifies which theme 
to apply. 

■ You define styles in a style resource file 
using the <style> element. The name 
attribute gives the style a name. The 
parent attribute specifies where the style 
should inherit its properties from. 

■ The default folder for style resource files 
is app/src/main/res/values. Put a style 
resource file in the app/src/main/res/ 
values-v21 folder if you want it to be used on 
API level 21. 



Add action items to your action bar by adding 
items to a menu resource file. 

Add the items in the menu resource 
file to the action bar by implementing the 
activity's onCreateOptionsMenu ( ) 

method. 

Say what items should do when 
clicked by implementing the activity’s 

onOptionsItemSelected ( ) 

method. 

You can share content by adding the share 
action provider to your action bar. Add it by 
including it in your menu resource file. Call 
its setSharelntent ( ) method to pass 
it an intent describing the content you wish 
to share. 

Add an Up button to your action bar to navigate 
up the app’s hierarchy. Specify the hierarchy in 
AndroidManifest.xml. Use the ActionBar 
setDisplayHomeAsUpEnabled ( ) 
method to enable the Up button. 
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Going Places + 




Apps are so much better when they’re easy to navigate. 

In this chapter, we’re going to introduce you to the navigation drawer, a slide-out panel 
that appears when you swipe the screen with your finger or click an icon on the action bar. 
We’ll show you how to use it to display a list of links that take you to all the major hubs 
of your app. You’ll also see how switching fragments makes those hubs easy to get to 
and fast to display. 



this is a new chapter 
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The Pizza app revisited 

In Chapter 9, we showed you a sketch of the top-level screen of the 
Pizza app. It contained a list of options to places in the app the user 
could go to. The first three options linked to category screens for pizzas, 
pasta, and stores, and the final option links to a detail/ edit screen where 
the user could create an order. 

This is -the Pizza app -top-level adtivity- 



These link -to dategory sdreens. 



This -takes you -to a de-tail/ edit sdreen where 
you dan dreate a new order. We moved this 
to the adtion bar in Chapter % 



ei-ts and. pl^as 

Pizzas 




Create Order 



So far you’ve seen how you can add action items to the action bar. This 
approach is best used for active options such as creating an order, but 
what about the category screens? As these are more passive and used for 
navigating through the app, we’ll take a different approach. 

We’re going to add the Pizzas, Pasta, and Stores options to a 
navigation drawer. A navigation drawer is a slide-out panel that 
contains links to the main parts of the app. These main parts are called 
the major hubs of the app, and they are typically the main navigation 
points within the app — the top-level screens and the categories: 



Bits and Pizzas 



This is -the navigation 
drawer. It don-tains the— > 

major bubs ot the app- 



Home 

Pizzas 

Pasta 

Stores 



When you dlidk on an item in the 
navigation drawer, the dontent 
-for that option is displayed here- 
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Navigation drawers deconstructed 



You implement a navigation drawer using a special type of layout 
called a DrawerLayout. The Drawer Layout manages two views: 



o 

o 



A view for the main content. This is usually a FrameLayout so that 
you can display and switch fragments. 

A view for the navigation drawer, usually a ListView. 



By default, the DrawerLayout displays the view containing the 
main content. It looks just like a normal activity: 



This is -the navigation drawer 
iton. Click on it or swift your 
tinker to open the drawer. 










When you click on the navigation drawer icon or swipe your finger 
from the edge of the screen, the view for the navigation drawer slides 
over the main content: 



This is -the navigation 
d\rav/c\r. li don-tains a 
lis-t o-f options. 




The dv-awev 
slides ovev the 
main don*tent 



This content can then be used to navigate through the app. 



So how does this affect the structure of the Pizza app? 
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The Pizza app structure 

We’re going to change MainActivity so that it uses a drawer layout. 
It will contain a frame layout for displaying fragments, and a list view to 
display a list of options. 

The list view will contain options for Home, Pizzas, Pasta, and Stores 
so that the user can easily navigate to the major hubs of the app. We’ll 
create fragments for these different options. This means that we’ll be 
able to switch the fragments at runtime, and the user will be able to 
access the navigation drawer from each of the different screens. 




PastaFragment StoresFragment 



Here are the steps we’ll go through to do this: 



o 

© 

© 

© 



Create fragments for the major hubs. 

Create and initialize the navigation drawer. 

The navigation drawer will contain a ListView displaying the list 
of options. 

Get the ListView to respond to item clicks. 

This will allow the user to navigate to the major hubs of the app. 

Add an ActionBarDrawerToggle. 

This lets the user control the drawer through the action bar and 
allows the activity to respond to drawer open and close events. 



We’ll start by creating the fragments. 



o 



Adding a 
navigation 
drawer 
takes a lot 
of code. 

We’re going to spend the rest of 
the chapter showing you how to 
add one, and we’ll show you the 
entire MainActivity.java code at 
the end. 
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Create TopFragment 

We’ll use TopFragment to display the top-level content. For now, 
we’ll use it to display the text “Top fragment” so that we know which 
fragment we’re displaying. Create a new blank fragment with a fragment 
name of TopFragment and a layout name of fragment_top. 



navigation drawers 

Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 

Were us'm$ a blank (ra<y*er\i (or all o( ouv 
-Pva^mcn'ts as weVe to replace all tbe 
lode J\r\dro\ A Studio ynevates (or us. 



Here’s the code for Top Fragment. java: 



package com.hfad.bitsandpizzas ; 

import android . os . Bundle ; 
import android . app . Fragment ; 
import android . view . Layoutlnf later ; 
import android. view. View; 

import android. view. ViewGroup; -r xz / , n , — i 1 

TopFrag«,entjava is a flam fragment com . hfa Sa ndpizzas 

public class TopFragment extends Fragment { 

TopFragment.java 

@ Override 

public View onCreateView (Layoutlnf later inf later , ViewGroup container, 

Bundle savedlnstanceState) { 

return inflater. inflate (R. layout . f ragmen t_top, container, false); 

} 

} 




□ 



BitsAndPizzas 



app/sre/main 

M3 



java 

IT — a 



Add the following string resource to strings. xml] we’ll use this in our 
fragment layout: 

<string name=" title_top">Top fragment</string> 



Add this to sbrmy.%w»|. Wc II use 
i-t in -the layout so we know when 
Toppragment is being displayed- 



Here’s the code for fragment_top.xml\ 



BitsAndPizzas 



<RelativeLayout xmlns : android= M http : //schemas . android . com/apk/res/android" 
xmlns : tools="http : //schemas . android.com/tools" 
android : layout_width="match_j?arent" 
android : layout_height="match_j?arent " 
tools : context=" .MainActivity"> 

<TextView 

android : text=" @ string/ title_top" 
android : lay out_width="wrap_con tent" 
android: layout_height="wrap_content" /> 

</RelativeLayout> 



□ 

Pizz 
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app/sre/main 

■ 



Co 

mu 

layout 



fragment_top.xml 



you are here ► 



401 



create PizzaFragment 



Create PizzaFragment 

We’ll use a List Fragment called PizzaFragment to display the 
list of pizzas. Create a new blank fragment with a fragment name 
of PizzaFragment, and untick the option to create a layout. This is 
because list fragments don’t need a layout — they use their own. 

Next, add a new string array resource called “pizzas” to strings. xml 
(this contains the names of the pizzas): 



Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 



<string-array name= M pizzas M > 

<item>Diavolo</item> ^ 

< i t em>Fungh i< / i t em> 
</string-array> 



array pizzas { o 



strihgs.xml. 



Then change the code for PizzaFragment.java so that it’s a 
List Fragment. Its list view should be populated with the pizza 
names. Here’s the code: 



package com.hfad.bitsandpizzas ; 



□ 

Bits And Pizzas 



import android . app . Lis tFragment ; 
import android . os . Bundle ; 
import android . view . Layoutlnf later ; 
import android. view. View; 
import android. view. ViewGroup; 
import android . widget . ArrayAdapter ; 



app/src/main 

m3 



Well use a ListfVa<y»e*t b> 
display l'*t ot pi*** 



java 



LQ 



-"“tar 



public class PizzaFragment extends ListFragment { 



PizzaFragment.java 



@ Override 

public View onCreateView (Layoutlnf later inf later , ViewGroup container , 

Bundle savedlnstanceState) { 

ArrayAdapter<String> adapter = new ArrayAdapter<String> ( 
inf later .getCon text () , 
android . R . layout . simple_lis t_item_l , 
getResources () . gets tringArray (R. array .pizzas) ) ; 

setListAdapter (adapter) ; 

return super . onCreateView (inf later , container, savedlnstanceState) ; 

} 

} 
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Create PastaFragment 



We’ll use a ListFragment called PastaFragment to display the 
list of pasta. Create a new blank fragment with a fragment name of 
PastaFragment. You can untick the option to create a layout as list 
fragments use their own layouts. 

Next, add a new string array resource called “pasta” to strings. xml (this 
contains the names of the pasta): 



<string-array name= M pasta M > 

<item>Spaghetti Bolognese</item> 
< i tem>La s agne< / i tem> 
</string-array> 



Add ihe array of pasta to strips.**,!. 



Then change the code for PastaFragment.java so that it’s a 
ListFragment. Its list view should be populated with the pasta 
names. Here’s the code: 



package com.hfad.bitsandpizzas ; 



□ 

BitsAndPizzas 



import android . app . ListFragment ; 
import android . os . Bundle ; 
import android . view . Layoutlnf later ; 
import android . view . View ; 
import android . view . ViewGroup ; 
import android . widget . ArrayAdapter ; 



We'll use a UstFra^ert to 
display the list of pasta- 



public class PastaFragment extends ListFragment { 



HB 

app/src/main 

MB 

java_ 

LQ 

com.hfad.bitsandpizzas 



PastaFragment.java 



@ Override 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstance State) { 

ArrayAdapter<String> adapter = new ArrayAdapter<String> ( 
inf later . getContext () , 
android . R . layout . simple_lis t_i tem_l , 
getRe sources ( ) . getStringArray (R . array . pasta) ) ; 

setListAdapter (adapter) ; 

return super . onCreateView (inf later , container, savedlnstanceState) ; 

} 

} 
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Create StoresFragment 

We’ll use a ListFragment called StoresFragment to display the 
list of pasta. Create a new blank fragment with a fragment name of 
“StoresFragment.” Untick the option to create a layout as list fragments 
define their own layouts. 

Next, add a new string array resource called “stores” to strings. xml (this 
contains the names of the stores): 



Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 






<string-array na 

<item>Cambridge</item> a.j j /» , 

<item>Sebastopol</itenc^ ^ ^ ^ ^ ’W*"' 

</string-array> 



Then change the code for StoresFragment.java so that it’s a 
ListFragment. Its list view should be populated with the store names. 
Here’s the code: 



package com. hfad.bitsandpizzas ; 



□ 

BitsAndPizzas 



import android . app . ListFragment ; 
import android . os . Bundle ; 
import android . view . Layoutlnf later ; 
import android. view. View; 

import android. view. ViewGroup; ^ e '|| wse a ListFra^ent 

import android. widget. ArrayAdapter; display "the list o-f stores- 

public class StoresFragment extends ListFragment { 



K3 

app/sre/main 

43 



java 



bo 



4TI 



com. hfad.bitsandpizzas 



StoresFragment.java 



QOverride 

public View onCreateView (Layoutlnf la ter inf later, ViewGroup container. 

Bundle savedlnstanceState) { 

ArrayAdapter<String> adapter = new ArrayAdapter<String> ( 
inf later . getContext () , 
android . R . layout . simple_lis t_i tem_l , 
getRe sources () . gets tringAr ray (R. array . stores) ) ; 

setListAdapter (adapter) ; 

return super . onCreateView (inf later , container, savedlnstanceState) ; 

} 

} 
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Add the Prawerlayout 



Next, we’ll change the layout of MainActivity.java so that it uses a 
DrawerLayout. As we said earlier, this will contain a FrameLayout 
that will display fragments, and a ListView for the navigation drawer. 



The layout uses the DrawerLayout tror* 
^^the v^r support library. The app£or*pat 

t library includes the vt 



The second element in the DrawerLayout defines the drawer itself 
If you use a ListView, this will display a drawer that contains a list 
of options. You usually want this to partially fill the screen horizontally 
when it slides out, so you set its layout_height attribute to 
"match_parent" and its layout_width attribute to a fixed width. 

We’ll show you the full code for activity _main. xml on the next page. 



You create the DrawerLayout using code like this: 

<android . support . v4 . widget . DrawerLayout library includes “the A support library 

xmlns : android="http : //schemas . android . com/ apk/res /android" 
android : id=" @+id/drawer_layout M 
android : layout_width="match_parent n 
android : layout_height= M match_j?arent"> 

The FrameLayout will be used -to display -fragments. 

<FrameLayout ^ 

android : layout_width= M match_j?arent" 
android : layout_height= M match_j?arent" 

... /> 

The ListView describes -the drawer 

<ListView 

andr o i d : 1 ay ou t_wi d th= " 2 4 0 dp " 
android : layout_height= M match_j?arent " 

... /> 

</android . support . v4 . widget . DrawerLayout> 

The DrawerLayout is the root component of the new layout. That’s 
because it needs to control everything that appears on the screen. 

The DrawerLayout class comes from the v4 support library, so 
we use its full class path of android . support . v4 . widget . 

DrawerLayout. 

The first element in the DrawerLayout is used to display the content. 

In our case, this is a FrameLayout that we’ll use to display fragments. 

You want this to be as large as possible, so you set its layout_width 
and layout_height attributes to "match_parent ". 



• 


V A u 10:54 


<- Bits And Pizzas 




Home 




Pizzas 




Pasta 




Stores 




The drawer is 
de-Pined by a 
Listl/iew. It should 
partially till the 
screen when it 
slides out- 


f 1 


<1 o 


h 



The dontent goes in a 
FrameLayout. You want 
•the dontent “to -fill “the ^ 
sdreen. At the moment) its 
partially hidden by the 
drawer. 
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layout code 



V 



The full code for activity_wain.xwl 



Here’s the full code for activity_main.xml : 



Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 



<android . support . v4 . widget . DrawerLayout 

xmlns : android= M http : //schemas . android.com/apk/res/android 
android : id= M @+id/drawer_layout" 
android : layout_width="match_j?arent" 
android : layout_height="match_parent"> 



<FrameLayout 

android : id= M @+id/content_f rame " 
android : layout_width="match_j?arent" 
android : layout_height="match_j?arent " 



* Fv-ajmeirrfcs will be 
displayed in -the 
F\rameLayou-t. 



□ 

BitsAndPizzas 

4B 

app/sre/main 

43 



/> 



co 

43 

layout 



/^CListView android! id — M @+id/ drawer" activity main. xml 

android : layout_width= " 2 4 Odp " The dv-awev- width- 

android : layout_height="match_jparent " 

android: layout_gravity=" start" ^ tVbeve *to plade *tbe dvawev- 

android: choiceMode="singleChoice" Select one rtem ai a -time, 
android : divider=" ©android : color/ transparent " 

android : dividerHeight=" Odp" ^ Swijdb o£C the divider lines between items and 
android : backgr 0 und= "#ffffff"/> ^ Set ba( % owwl toW 
</android . support . v4 . widget . DrawerLayout> 



Tbe 

List\/iew / 
describes A 
tbe 

drawer- 



Take a careful note of the settings we’re using with the <ListView> 
element, as any navigation drawer you create is likely styled in a 
similar way. 

To set the size of the drawer, you use the layout_width and 
layout_height attributes. We’ve set layout_width to “240dp” 
so that the drawer is 240dp wide when it’s open. 

Setting the layout_gravity attribute to "start" places the 
drawer on the left in languages where text runs from left to right, and 
places it on the right in countries where text runs from right to left. 

The divider, dividerHeight, and background attributes 
are used to switch off divider lines between the options and set the 
background color. 

Finally, setting the choiceMode attribute to "singleChoice" 
means only one item can be selected at a time. 



U- 

■J ■ If your project 
doesn’t include 
a dependency 
Watch it! on the v7 
appeompat 
support library, the 
navigation drawer code in 
this chapter won’t work. 



You manage dependencies 
by navigating to File^ Project 
Structure^ App^Dependencies. 
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Initialize the drawer's list 



Now that we’ve added a drawer layout to activity _main. xml, we need to 
specify its behavior in MainActivity.java. The first thing we’ll do is populate 
the list view. To do this, we’ll add an array of options to strings. xml. We’ll 
then use an array adapter to populate the list. 

Here’s the array of strings you need to add to strings. xml (each item in the 
array refers to which fragment you want to display when it’s clicked): 



BitsAndPizzas 



<string-array name=" titles "> 

<item>Home</item> K. T j, ese av - e the options that will be 
<item>Pizzas</item> displayed in *the navigation drawer. 

<item>Pasta</item> Add the array to striny-*m|. 

< i tem>S to r e s< / i tem> 

</string-array> 

We’ll populate the list view in MainActivity.java' s onCreate ( ) method. 

We’ll use private variables for the array and list view as we’ll need these 
later on. Here’s the code: 



□ 

Pizz 

43 

app/sre/main 

43 



43 

values 



strings.xml 



VVeVe usin^ these 



a 



import android . widget . ArrayAdapter ; ~ ^ ^ ^ BjtsA ^p% a s 

import android. widget . Lis tView; import thei 



public class MainActivity extends Activity { 

private String [] titles; ^ ^ l/Ve II use these in other methods 

private ListView drawerList; later on, so add them as private 

elass variables. 

QOverride 

protected void onCreate (Bundle savedinstanceState ) { 



app/sre/main 

4H 

java_ 

LQ 

com.hfad.bitsandpizzas 

□ 

MainActivity.java 



titles = getResources () . gets tringArray (R. array . titles) ; 
drawerList = (ListView) findViewBy Id (R. id. drawer) ; 
drawerList . setAdapter (new ArrayAdapter<String> ( this , *C~ 

android. R. layout . simple_list_item_activated_l , titles) ) ; 

} t 

Using simplejist3tem_activiated_l means -that 
ihe item the user clicks on is highlighted- 

Now that we’ve populated the list view with a list of options, we’ll get the 
list to respond to item clicks. 



Use an ArrayAdapter to 
populate the ListView- 
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Use an OnltemClickListener to respond 
to clicks in the list view 



V 



Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 



You get the list view to respond to clicks in the same way that we did 
in Chapter 6, by using an onltemClickListener. We’re going 
to create the listener, implement its onltemClick ( ) method, and 
assign the listener to the list view. Here’s the code: 



import android. view. View; 

import android . widget . AdapterView ; 



VVcVc usm^ -these 

^ dlasses, so we need -to 



import then 

public class MainActivity extends Activity { 



□ 



BitsAndPizzas 



4T3 

app/src/main 

KU 



java 



m3 



com.hfad.bitsandpizzas 

L @ 

MainActivity.java 



This describes the 0*lter»ClitkListe»ev-. 

\r 

private class DrawerltemClickListener implements ListView. OnltemClickListener { 
@ Override 



public void onltemClick (AdapterView<?> parent. View view, int position, long id) { 
//Code to run when the item gets clicked 

} t 

1/Vhen “the user didks on an item in the navigation 
drawer, the onltemCli^kO method je-ts called- 



@Override 

protected void onCreate (Bundle savedinstanceState) { 



drawerList . setOnltemClickListener (new DrawerltemClickListener () ) ; 
Add a new instance ot our OnltemClickListener to the drawer s Listl/iew. 



The onltemClick ( ) method needs to include the code you want to 
run when the user clicks on an item in the list view. We’ll get it to call a 
new selectltemO method, passing in the position of the selected 
item. We’ll write this method next. 



The method should do three things: 



o 

o 

o 



Switch the fragment in the frame layout. 

Change the title in the action bar to reflect the layout. 
Close the navigation drawer. 



You already know everything you need in order to do the first of these 
tasks, so have a go at the exercise on the next page. 
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Code Magnets 



When the user clicks on an item in the navigation drawer list view, we need 
to display the correct fragment in the content_f rame frame layout. See 
if you can finish the code below. 



private void selectltem (int position) 
Fragment fragment; 



switch ( 

case 1 : 



) { 



fragment = 
break; 
case 2 : 

fragment = 
break; 
case 3 : 

fragment = 
break; 
default : 

fragment = 



i\\t LisWiew- 





PizzaFragment () 



] 



TopFragment () | 



fragment 

StoresFragment (T~| 



PastaFragment ( ) 



] 



commit () 



} 



FragmentTransaction ft = getFragmentManager ( ) . 
ft . replace (R. id. content_f rame, ) ; 



f t . addToBackStack (null ) ; 

ft . setTransition (FragmentTransaction . TRAN S I T_FRAGMENT_FADE ) , 



} 



ft . 
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Code Magnets Solution 

When the user clicks on an item in the navigation drawer list view, we need 
to display the correct fragment in the content_f rame frame layout. See 

if you can finish the code below. . , ^ 

These are the items ^ 

in the Listyev/- 



Home 

Pizzas 

Pasta 

Stores 



private void selectltem (int position) { 



Fragment fragment; 




Chedk the Position in the drawer’s 
List\/iew o-r the item that was elieked- 



case 1 : 



fragment = ■ new 
break; 
case 2 : 



PizzaFragment () 



- Create a -type of fragment 
that's appropriate -for the 
position. |- p the user elieks 
on 'Pizzas”, -for example, 

eveate a PizzaFragment. 



fragment = 
break; 
case 3 : 

fragment = 
break; 
default : 

fragment = 



PastaFragment ( ) 



StoresFragment 0 | . 



TopFragment () J . 



By default, Create a TopFragment 



FragmentTransaction ft = getFragmentManager ( ) . 

ft . replace (R. id. content_f rame, [ faagmenQ ); <£_ Begin a fragment 

transaction to replace the 

ft . addToBackStack (null) ; -fragment that's displayed, 

ft . setTransition (FragmentTransaction . TRAN S I T_FRAGMENT_FADE ) ; 




ft . 



commit () 1 . Commit the transaction- 
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The selectltemO method so far 

Here’s our revised MainActivity.java code (when an item in the 
navigation drawer gets clicked, it calls the select Item ( ) , which 
method displays a fragment): 



import android . app . Fragment ; 

import android . app . FragmentTransaction ; 

public class MainActivity extends Activity { 



□ 

BitsAndPizzas 

app/src/main 

L a 



java 



LQ 



com . hfad . bitsandpizzas 
L @ 

MainActivity.java 



private class DrawerltemClickListener implements ListView . OnltemClickListener { 
@Override 

public void onltemClick (AdapterView<?> parent, View view, int position, long id) { 

selectltem (position) ; ^ ^ se | e£ ytemO method when 

* an item gets clicked- 



} 



private void selectltem (int position) { 
Fragment fragment; 
switch (position) { 
case 1 : 

fragment = new PizzaFragment () ; 
break ; 
case 2 : 

fragment = new PastaFragment () ; 
break ; 
case 3 : 

fragment = new StoresFragment () ; 
break ; 
default : 

fragment = new TopFragment ( ) ; 

} 



■ Chcdk "the position o*P *thc rtcm dlidked- 



- Mse the position to Create the right type 
o+ +\rdgr*ent The Tiz z3s” option is at 
position / , -for instate, so in this ease 

Create a PizzaFvagmeht- 



Create a TopFragment by default 



FragmentTransaction ft = getFragmentManager () .beginTransaction () ; 
ft. replace (R. id. content_frame , fragment) ; 
ft . addToBackStack (null) ; 

ft . setTransition (FragmentTransaction . TRANSIT_FRAGMENT_FADE) ; 
ft. commit (); ^ 

} Use fragment transaction to replace 

the -fragment that's displayed. 



Now that the selectltem () method displays the correct fragment, 
we’ll get it to change the action bar title. 
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Changing the action bar title 

In addition to switching the fragment that’s displayed, we need to 
change the title of the action bar so that it reflects which fragment 
is displayed. By default, we want the action bar to display the name 
of the app, but if the user clicks on the Pizzas option, for example, 
we want to change the action bar title to “Pizzas”. This will help the 
user know where they are in the app. 

To do this, we’ll use the position of the chosen item to get the title 
that should be displayed from the titles array. We’ll then update the 
action bar title using the ActionBar setTitle ( ) method. We’ll 
put this in a separate method as we’ll need it later on. Here’s the 
code: 



v 



Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 



private void selectltem ( int position) 



□ 

BitsAndPizzas 



//Set the action bar title 

setActionBarTitle (position) ; <r~ Call the setActionTitleO 

method, passing it the position 

* ot the item that 'was clicked on. 

private void setActionBarTitle (int position) { 

String title; l*f "the user elidks ok -the u Wor*e” 

if (position == 0) { the app name tor the title. 

title = getResources () . gets tring (R. string . app_name) ; 



43 

app/sre/main 

HU 



java 



LQ 



com.hfad.bitsandpizzas 

op-iioK, use | 



MainActivity.java 



} else { 

title = titles [position] ; 

} 



Otherwise, jet the String -from the titles array tor 
the position that was clicked and wse that 



getActionBar ( ) . setTitle (title) ; £ isp | ay fa ^ m fa bav . 

} 
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Closing the navigation drawer 

The final thing we’ll get the select Item ( ) code to do is 
close the navigation drawer. This saves the user from closing it 
themselves. 

You close the drawer by getting a reference to the 
Drawer Layout and calling its closeDrawer ( ) method. 

The closeDrawer ( ) method takes one parameter, the View 
that you’re using for the navigation drawer. In our case, it’s the 
ListView that displays the list of options: 

private void selectltem (int position) { 

z / , £jet a evende to -the PvawevLayout- MainActivity.java 

//Close the drawer 

DrawerLayout drawerLayout = (Drawer Lay out) findViewByld (R. id. drawer_layout) ; 

drawerLayout. closeDrawer (drawerList) ; drawerList « the DrawerLayout's drawer. This tells 
} the Drawer Layout to dlose the drawerList drawer. 



□ 

BitsAndPizzas 

Hr 3 

app/sre/main 

4 a 



java 



LQ 



com. hfad.bitsand pizzas 



The entire screen is 

the Prawer Layout- It — ■ 
Contains a FvameLayout 
where the Content goes, 
a*d a Listl/iew whieh is 
used -for the drawer. 



* 


V A u 10:54 


<- Bits And Pizzas 


i 


Home 




Pizzas 




Pasta 




Stores 





You need to tell the * 
PrawerLayout to dlose 
its ListView drawer. 



Now that you’ve seen all the components needed for the 
selectltem ( ) code, let’s look at the full code and how it’s 
used in MainActivity. 



you are here ► 
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The updated MainActivity .java code 

Here’s the updated code for MainActivity. java\ 



v 

v/ 

-►EZI 



Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 



package com. hfad. bitsandpizzas; 



□ 



BitsAndPizzas 



pv-av/erLayou-t is m 

import android. support .v4 .widget .DrawerLayout; -the v^T suyyovt library- 



public class MainActivity extends Activity { 



Hfl 

app/src/main 

413 



java 



m3 



com. hfad. bitsandpizzas 



private DrawerLayout drawerLayout ; ihc Dvav/cvLayoui as a privaie variable, MainActivity.java 

as wc II use i-t in multiple methods. 



private class DrawerltemClickListener implements ListView . OnltemClickListener { 
@Override 

public void onltemClick (AdapterView<?> parent, View view, int position, long id) { 
//Code to run when an item in the navigation drawer gets clicked 
selectltem (position) ; ^ selc^tltcmO method. 

} 

} ; 



QOverride 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_main) ; 

titles = getResources (). getStringArray (R. array . titles) ; 
drawerList = (ListView) findViewByld (R . id . drawer ) ; 

drawerLayout = (DrawerLayout) findViewByld (R. id. drawer_layout) ; 

//Populate the ListView 

drawerList . setAdapter (new ArrayAdapter<String> (this , 

android. R. layout . simple_list_item_activated_l, titles) ) ; 
drawerList . setOnltemClickListener (new DrawerltemClickListener ( ) ) 

if (savedlnstanceState == null) { 

selectltem ( 0 ) ; ^ ^ ^ is ^ drealed, use the 

} selefttl W) «>Ahod to display T 0 yPta 3 n.er.i- 



fci a 'ct$vctY\U io -the 
DvawcvLayou-t. 



The dode Continues 

on -the ne*t pay. 
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The MainActiviiy.java code (continued) 

private void selectltem (int position) { 

// update the main content by replacing fragments 
Fragment fragment; 

switch (position) { £jet the v-i$ht •fragment to display 

case 1 : ^ 

fragment = new PizzaFragment ( ) ; 
break; 
case 2 : 

fragment = new PastaFragment ( ) ; 
break; 
case 3 : 

fragment = new StoresFragment ( ) ; 
break; 
default : 

fragment = new TopFragment ( ) ; 



□ 

Bits And Pizzas 

4a 

app/src/main 

na 

java_ 

LQ 

com. hfad.bitsand I pizzas 



Display "the -fragment using a 
tvaAment transaction. 

} £ 

FragmentTransaction ft = getFragmentManager ( ) . beginTransaction ( ) ; 

ft . replace (R. id. content_f rame, fragment) ; 
ft . addToBackStack (null) ; 

ft . setTransition (FragmentTransaction . TRAN S I T_FRAGMENT_FADE ) ; 
ft . commit ( ) ; 

//Set the action bar title 

, ... . Set “the action bar title- 

setActionBarTitle (position) ; < — 

//Close drawer 

drawerLayout . closeDrawer (drawerList) ; Close the drawer. 



a 

MainActivity.java 



} 



private void setActionBarTitle (int position) { 

String title; |£ ^ wsev . £ |',tks on the "Home” option, use the apf> name tov the title. 



if (position == 0) { ^ 

title = getResources () . gets tring (R. string . app_name) ; 

} else { 

title = titles [position] ; Mhevwise, get the String tom the titles away tov 
} the position that was disked and use -tha-t 

getActionBar () . setTi tie (title) ; ^ — Display the 'title in the action bav - . 



lAfe^ve omitted the onCreateOptionsMenuO and 
onOptions|temSelectedO methods -from our original 
ManActivity Code, as these haven't changed- 
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fret the drawer to open and close 

So far we’ve added a navigation drawer to MainActivity, 
populated it with a list of the major hubs in the app, and got the 
activity to respond when an item is clicked. The next thing we’ll 
look at is how to open and close the drawer, and how to respond 
to its state. 

There are a couple of reasons why you might want to respond 
to the state of the navigation drawer. First, you might want to 
change the title of the action bar when the navigation drawer 
opens and closes. You might, say, want to display the app name 
when the drawer is open, and display the selected fragment when 
the drawer is closed. 

Another reason relates to the action items on the action bar. 

When the drawer is open, you may want to hide some or all of 
these action items so that the user can only click on them when 
the drawer is closed. 

Over the next few pages, we’re going to show you how to set up a 
DrawerListener so that you can listen for DrawerLayout 
events. We’ll use it to hide the share action on the action bar when 
the navigation drawer is open, and make it visible again when the 
drawer closes. 



Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 



o 

We know it seems 
like you have to 
take care of a lot 
of things when you 
create a navigation 
drawer. 

Even though the code might seem 
complex, stick with it and you’ll be fine. 





Well get the drawer 

to open and dose * 

using a button on 
the action bar. 



Top fragment 



Bits And Pizzt YhaiT) 



Settings 



1 Men the drawer is dlosed, 
display the Share adW i« 
-the adtion bar. 
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Using an ActionParPrawerToggle 

The best way of setting up a DrawerListener is to use an 
ActionBarDrawerToggle. An ActionBarDrawerToggle 
is a special type of DrawerListener that works with an action 
bar. It allows you to listen for Drawer Lay out events like a normal 
DrawerListener, and it also lets you open and close the drawer by 
clicking on an icon on the action bar. 

You start by creating two String resources in strings. xml that describe 
the “open drawer” and “close drawer” actions. These are needed for 
accessibility: 

<string name= " open_drawer " >Open drawer</string> 



A 



□ 

BitsAndPizzas 

hb 

app/src/main 

MB 



<string name= " close_drawer " >Close drawer</string> 

“these “to sbrineys.*m|. 



Then create a new ActionBarDrawerToggle by calling its 
constructor and passing it four parameters: a Context (usually this 
for the current Context), the Drawer Layout, and the two String 
resources. You then override the ActionBarDrawerToggle’s 

onDrawerClosed ( ) and onDrawerOpened ( ) methods: 



TheyVe needed (or -the 
AttionBavPvav/evlo^le. 



CO 

4 ■ 



values 



Cvea-te -the AdtionBar Drawer loggl. 

A 

ActionBarDrawerToggle drawerToggle = new ActionBarDrawerToggle (this , drawerLayout , 
R . string . open_drawer , R . string . close_drawer ) { 



strings.xml 



This method $ets tailed when 
the dvawev is dosed- 



//Called when a drawer has settled in a completely closed state 
@ Override 

public void onDrawerClosed (View view) { 
super . onDrawerClosed (view) ; 

//Code to run when the drawer is closed 

This method J^ts tailed when the dv-aweir is open- 

//Called when a drawer has settled in a completely open state. 

@ Override 

public void onDrawerOpened (View drawerView) { 
super . onDrawerOpened (drawerView) ; 

//Code to run when the drawer is open 

} 



} ; 



Once you’ve created the ActionBarDrawerToggle, you 
set it to the DrawerLayout using the DrawerLayout’s 
setDrawerListener ( ) method: 



□ 

BitsAndPizzas 

■ 

app/src/main 

MB 

java 

HB 



com.hfad.bitsandpizzas 

AttionBavPvawcv-lo^lc | |“ 

* as the Pv-awevLayowts 

drawerLayout . setDrawerListener (drawerToggle) ; MainActivity.java 
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invalidateOptionsMenuQ 



Modifying action bar items at runtime 

If you have items on your action bar that are specific to the contents of 
a particular fragment, you may want to hide them when the drawer is 
open, and display them again when the drawer is open. When you need 
to modify the contents of the action bar in this way, you have to do two 
things. 




Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 



First, you need to call the activity’s invalidateOptionsMenu ( ) 
method. This tells Android that the menu items that need to be on the 
action bar have changed and should be re-created. 

When you call the invalidateOptionsMenu ( ) method, the activity’s 
onPrepareOptionsMenu ( ) method gets called. You can override this 
method to specify how the menu items need to change. 

We’re going to change the visibility of the share action on our action 
bar depending on whether the drawer is open or closed. We therefore 
need to call the invalidateOptionsMenu ( ) method in the 
onDrawerClosed ( ) and onDrawerOpened ( ) methods of the 
ActionBarDrawerToggle: 

public void onDrawerClosed (View view) { 



□ 

BitsAndPizzas 

kj 

app/src/main 

L Q 

java_ 

LQ 



com.hfad.bitsandpizzas 

L @ 

MainActivity.java 



super . onDrawerClosed (view) ; 

invalidateOptionsMenu () ; 



public void onDrawerOpened (View drawerView) 
super . onDrawerOpened (drawerView) ; 

invalidateOptionsMenu ( ) ; I 



The invalidateOptionsMenuO 

■ method "tells /Wvoid to ve— 
tveate the mem* items. We want 
to thange the visibility o-f the 
^ Shave attion it the dvawev is 
opened ov tlosed, so we tall it 

in the onDvawevOpenedO and 

methods- 



We then use the activity’s onPrepareOptionsMenu ( ) method to set 
the visibility of the share action: 

//Called whenever we call invalidateOptionsMenu () 

0 Override ^ invalidate0ptions/WenuO gets tailed- 

public boolean onPrepareOptionsMenu (Menu menu) { 

// If the drawer is open, hide action items related to the content view 
boolean drawerOpen = drawerLayout . isDrawerOpen (drawerList) ; 



The onPvepave0ptions/WenuO 
method gets tailed whenever 



menu. find!tem(R. id. action_share) . setVisible ( ! drawerOpen) 



return super . onPrepareOptionsMenu (menu) 



On the next page, we’ll take you through the full code. 



a: 

Set the Shave attion's visibility 
to -false if the dvawev is open, 
set it to true i-f it isn't- 
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The updated MainActivity.java code 

Here’s the revised code for MainActivity.java : 



□ 



public class MainActivity extends Activity { 



_ . _ ^ m n BitsAndPizzas 

import android . support . v7 . app . ActionBarDrawerToggle ; i p 3 

* L LJ 

A^tiohBavPv-a^cv-To^lc app/src/main 
is m *the v7 app£ompa*t I — | 

library- 

private ActionBarDrawerToggle drawerToggle ; 

"this as a private variable, as v/cll use i-t in multiple methods. 

QOverride 



protected void onCreate (Bundle savedinstanceState ) { 



java 



MC3 



com. hfad.bitsand pizzas 



MainActivity.java 



//Create the ActionBarDrawerToggle 

drawerToggle = new ActionBarDrawerToggle (this , drawerLayout , 

R . string . open_drawer , R . string . close_drawer ) { 

//Called when a drawer has settled in a completely closed state 
public void onDrawerClosed (View view) { 

super , onDrawerClosed (view) ; ^ „ Ke „ 

invalidateOptionsMenu ( ) ; ^ ,, , 

1 t 

//Called when a drawer has settled in a completely open state, 
public void onD rawer Opened (View drawerView) { 
super . onDrawerOpened (drawerView) ; 
invalidateOptionsMenu () ; 

} . } Se ^ the DrawerLayout's drawer listener as the Action&arDrawerTo^le. 

drawerLayout. setDrawerListener (drawerToggle) ; •j 



//Called whenever we call invalidateOptionsMenu () _ , , , ... o .j. 

Set the visibility ok the Share action 

0 Override w heK the drawer is opened and closed- 

public boolean onPrepareOptionsMenu (Menu menu) { 

// If the drawer is open, hide action items related to the content view 
boolean drawerOpen = drawerLayout . isDrawerOpen (drawerList) ; 
menu . findltem (R. id. action_share) . setVisible ( ! drawerOpen) ; 
return super . onPrepareOptionsMenu (menu) ; 

} 
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Enable the drawer to open and close 



We’ve added a navigation drawer to MainActivity, populated it 
with a list of options, got the activity to respond when an option is 
clicked, and seen how to hide action items when the drawer is open. 
The final thing we’ll do is let the user open and close the drawer by 
clicking on an icon in the action bar. 

As we said earlier, this functionality is one of the advantages of using 
an Act ionBar Drawer Toggle. To switch it on, we need to add 
some extra code. We’ll take you through the code changes individually, 
then show you the full MainActivity.java code right at the end. 

First, you enable the icon in the action bar. You do that using these 
two method calls in the activity’s onCreate () method: 



getActionBar () . setDisplayHomeAsUpEnabled (true) ; 
getActionBar () . setHomeButtonEnabled (true) ; 



These lines of code enable the activity’s Up button. As we’re using an 
Act ionBar Drawer Toggle, the Up button will be used to activate 
the drawer instead of navigating up the app’s hierarchy. 




Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 




The MtionBarDv-aweirToggle lets 
you use the action ba/s up buttoi 
to open and dose the dv-awev-. 









Enable -tbe Up button so you 
dan use it tor tbe drawer- 



Next, you need to get the ActionBarDrawerToggle to handle 
being clicked. To do this, you call its onOptionsItemSelected ( ) 
method from within the activity’s onOptionsItemSelected ( ) 
method like this: 



@0verride 

public boolean onOptionsItemSelected (Menultem item) 

if (drawerToggle .onOptionsItemSelected (item) ) { 

return true; 

} 

//Code to handle the rest of the action items 



{ 

^Wou need i o add -these lines of Code to 
the on0j>tions|te**SeledtedO method so 
that the ActionBarDrawerToggle dan 

handle being elieked. 



} 

} 

The code 

drawerToggle . onOptionsItemSelected (item) 

returns true if the ActionBarDrawerToggle has handled being 
clicked. If it returns false, this means that another action item in the 
action bar has been clicked, and the rest of the code in the activity’s 
onOptionsItemSelected ( ) method will run. 



□ 



BitsAndPizzas 



lo 

app/sre/main 

4U 



java 



4n 



com. hfad.bitsand pizzas 



MainActivity.java 
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Syncing the ActionParPrawerToggle state 

There are just two more things we need to do in order to get our 
Act ionBar Drawer Toggle working properly. 

First, we need to call the ActionBarDrawerToggle’s * . , 

syncState() method from within the activity’s postCreate() love it it “the navi^a ior» , 

method. The syncState() method synchronizes the state of the ^ — ' handled this tor you au ma i£a j, 
drawer icon with the state of the DrawerLayout. doesn't- Y ou t 1 ^° UV " t 



= Bits And Pizzas 

fop fragment 







SyKdmg the state «>ea«s that the 
drawer idon appears o«e way when 
the drawer is dlosed, and another 
way when the drawer is open. \ 



You need to call the syncState () method in the 
activity’s onPostCreate () method so that the 
Act ionBar Drawer Toggle is in the right state after the 

activity is created: . , 

You need to add -this method to 

@ Override ^ a^ivity so that the state ok 

protected void onPostCreate (Bundle savedlnstanceState) { the A^tionBarPrawerloJjle is in 

super .onPostCreate (savedlnstanceState) ; ^ — syne with the state ot the drawer. 

// Sync the toggle state after onRestorelnstanceState has occurred. 
drawerToggle . syncState ( ) ; p 

} WB 

BitsAndPizzas 

Finally, if the device configuration changes, we need to pass details HU 

of the configuration change to the ActionBarDrawerToggle. app/sre/m ain 

We do this by calling the ActionBarDrawerToggle’s L Q 

onConf rguratronChanged ( ) method from within the j ava 

activity’s onConf igurationChanged ( ) method: nr 

com.hfad.bitsandpizzas 

@ Override l_T 

public void onConf igurationChanged (Configuration newConfig) { 
super . onConf igurationChanged (newConfig) ; 

> 

drawerToggle . onConf igurationChanged (newConfig) ; 

} 



We’ll show you where the latest code changes fit into MainActivity. 
java on the next page, and then we’ll see what happens when we 
run the app. 



MainActivity.java 

’ Vo\A need bo add -this method 
■to your activity so that any 
£ontijuration changes jet passed 
to the MtionBarDrawerTojjle- 
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The updated MainActivity .java code 

Here’s the revised code for MainActivity.] ava: 



v 

v/ 

►v/ 



Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 



import android . content . res . Configuration ; 

Import "this class as its used by "the onComfi^urationChai'igedO method- 

public class MainActivity extends Activity { 

private ActionBarDrawerToggle drawerToggle; 

QOverride 

protected void onCreate (Bundle savedinstanceState) { 



□ 

BitsAndPizzas 

43 

app/src/main 

HU 



java 
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com.hfad.bitsandpizzas 

L-0 

MainActivity.java 



getActionBar () . setDisplayHomeAsUpEnabled (true) ; ^ablc the Up iton so 

getActionBar () . setHomeButtonEnabled (true) ; it ean be used by the 

AdtionBarDrawerTo^le. 



@ Override 

protected void onPostCreate (Bundle savedinstanceState) { 

super. onPostCreate (savedinstanceState) ; Syw . ihe ^ J ^ ^BarlWrTo^ 

drawerToggle . syncState ( ) ; with the state o-P the drawer. 

} 

@ Override 

public void onConfigurationChanged (Configuration newConfig) { 

super . onConfigurationChanged (newConfig) ; \ p ass ^ ton .f j^-ation dhar^es to 

drawerToggle . onConfigurationChanged (newConfig) ; . ,»Bav*Pvawcv-To^lc. 

} 



QOverride 

public boolean onOptionsItemSelected (Menultem item) 

if (drawerToggle. onOptionsItemSelec ted ( i tem) ) { 

return true; 

} 

//Code to handle the rest of the action items 
switch (item. getitemid ( ) ) { 



{ 

Let the Ad/ionBav-Dv-awev-Toggle 
bardie being disked- 



} 
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Test drive the app 



When we run the app, Main Activity is displayed. It features a 
working navigation drawer: 




hidden when the drawer is open: 




The Shave 
aetion is 
visible i-f the 
d vawev is 
dosed- 



There’s just one thing we need to sort out: we need to make sure 
the correct title in the action bar is displayed when the device is 
rotated or the user presses the back button. So what currently 
happens? 





▼ A u 10:54 


<- Bits And Pizzc 





The Shave adtioh is hidden 
i-P the dvawev is ope*. 



you are here ► 
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more rotation problems 



The title and fragment are getting out of sync 



When we click on one of the options in the navigation drawer, the 
title in the action bar reflects the fragment that’s displayed. As an 
example, if you click on the Pizzas option, the action bar title gets set 
to “Pizzas”: 




If you click on the Back button, the title isn’t updated to reflect the 
fragment that’s displayed. As an example, suppose you click on 
the Stores option, followed by the Pizzas option. A list of pizzas is 
displayed and the title reflects this. If you then click on the Back 
button, StoresFragment is displayed but the title is “Pizzas”: 



The adiioK bar -ti-fcle s-tays 
the same whe* we dliek ok the 
Ba^k buttoK. |k this ease, it 
says Tizzas" wheK a list o-P 
stoves is displayed 




If you rotate the device, the title reverts to “Bits and Pizzas” 
irrespective of what fragment is displayed: 



The action bar title is reset 
when you rotate the device- 





*A U 11:31 


= Bits And Pizzas 


s + : ■ 


Cambridge 


□ 


Sebastopol 


| 



Let’s fix these problems, starting with keeping the action bar title in 
sync when the device is rotated. 
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Pealing with configuration changes 



As you already know, when you rotate your device, the current activity 
gets destroyed and re-created. This means that any user interface 
changes you have made are lost, including changes to the action bar title. 

Just as we did in earlier chapters, we’ll use the activity’s 
onSavelnstanceState ( ) method to save the position of the 
currently selected item in the navigation drawer. We can then use this in 
the onCreate () method to update the title in the action bar. 

Here are the code changes: 



public class MainActivity extends Activity { 



private int currentPosition = 0; 

Set duv-rerrlPosition to O by de-fault 

@Override 

protected void onCreate (Bundle savedinstanceState ) 



□ 

BitsAndPizzas 

HU 

app/sre/main 

HU 

java_ 

LU 



} 



com.hfad.bitsandpizzas 

//Display the correct fragment, 
if (savedinstanceState != null) { MainActivity.java 

currentPosition = savedinstanceState . getlnt ("position") ; 




setActionBarTitle (currentPosition) 
} else { 

selectltem(O) ; 

} t 

l-f the activity s newly treated, 
display “fbpF'v-a^^e^t 



^ activity has been destroyed 
a»d me-direated, set the value of 
euirirChtPositioh -from the adti vity^s 
previous state a*d use it to set the 
aetioh bar title- 



private void selectltem (int position) { 

currentPosition = position; Update dumrrtPosition v/he* a» iter. 



is selected- 



} 



} 



0 Override 

public void onSavelnstanceState (Bundle outState) { 
super . onSavelnstanceState (outState) ; 
outState . putlnt ( "position" , currentPosition) ; 



} 




Save the state of duv-\rer>tPositio* i-f 
the activity's (jo’mj to be destroyed- 
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Reacting to changes on the back stack 



The final thing we need to address is how to make the action bar 
title reflect the fragment that’s displayed when the user clicks on 
the back button. We can do this by adding a FragmentManager . 
OnBackStackChangedListener to the activity’s fragment 
manager. 

The FragmentManager . OnBackStackChangedListener 
interface listens for changes to the back stack. This includes when a 
fragment transaction is added to the back stack, and when the user 
clicks on the back button to navigate to a previous back stack entry. 

You add an OnBackStackChangedListener to the activity’s 
fragment manager like this: 



□ 

Bits And Pizzas 

HB 

app/src/main 

lo 



java^ 

La 

com . hfad . bitsand pizzas 




MainActivity.java 



get FragmentManager () . addOnBackStackChangedListener ( 

new FragmentManager . OnBackStackChangedListener ( ) { 



public void onBackStackChanged () { 



//Code to run when the back stack changes 



} 



} 

) ; 

When the back stack changes, the 

OnBackStackChangedListener’s onBackStackChanged ( ) 
method gets called. Any code you want to run when the user clicks 
on the back button should be added to this method. 



You add a new Fragment Manager. 

OnBadkStadkCbangedLis-tener, 
implementing its onBadkStadkChangedO 

method. This method is tailed whenever 
the badk stadk dbanges. 



When the onBackStackChanged ( ) method gets called, we want 
to do three things. 



o 

o 

o 



Update the currentPosition variable so that it reflects the position 
in the list view of the currently displayed fragment. 

Gall the se t Ac tionBar Title ( ) method, passing it the value of 
currentPosition. 

Make sure that the right option in the navigation drawer’s list view is 
highlighted by calling its set I temChecked ( ) method. 



Each of these depends on us knowing the position in the list view of 
the currently displayed fragment. So how do we work this out? 
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Adding tags to fragments 



To work out what the value of currentPosition should be, 
we’ll check what type of fragment is currently attached to the 
activity. As an example, if the attached fragment is an instance of 
PizzaFragment, we’ll set currentPosition to 1. 

We’ll get a reference to the currently attached fragment by adding a 
String tag to each fragment. We’ll then use the fragment manager’s 
f indFragmentByTag ( ) method to retrieve the fragment. 

You add a tag to a fragment as part of a fragment transaction. Here’s 
the current fragment transaction we’re using in our select Item ( ) 
method to replace the fragment that’s currently displayed: 



□ 

BitsAndPizzas 

H3 

app/src/main 
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java 
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com.hfad.bitsandpizzas 

L @ 

MainActivity.java 



FragmentTransaction ft = getFragmentManager (). beginTransaction () ; 
ft . replace (R. id. content_f rame , fragment) ; 
f t . addToBackStack (null ) ; 

ft . setTransition (FragmentTransaction . TRAN S I T_FRAGMENT_FADE ) ; 
ft . commit ( ) ; 



To add a tag to the fragment, you add an extra String parameter to 
the replace ( ) method in the transaction: 



FragmentTransaction ft = getFragmentManager (). beginTransaction () ; 



ft . replace (R. id. content_f rame , fragment, M visible_fragment n 
ft . addToBackStack (null) ; 

ft . setTransition (FragmentTransaction . TRANSIT_FRAGMENT_FADE) 
ft . commit ( ) ; 

In the above code, we’re adding a tag of "visible_f ragmen t" 
to the replace ( ) method. Every fragment that’s displayed in 
MainActivity will be tagged with this value. 



This adds a -tag ot 
'VisibleJVagweh-t" k> 

the -(Vagmeht as it^s 
added to the badk 
stadk. 



Next, we’ll use the fragment manager’s f indFragmentByTag ( ) 
method to get a reference to the currently attached fragment. 
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playing tag 



Find the fragment using its tag 



To retrieve the fragment that’s currently attached to the activity, 
we’ll pass the tag we set as part of the fragment transaction to the 
f indFragmentByTag ( ) method: 



pmd a with a 

ta$ ot u visible ^va^neyrt • 



FragmentManager fragMan = getFragmentManager () ; 

Fragment fragment = fragMan . f indFragmentByTag ( M visible_fragment M ) ; 

The f indFragmentByTag ( ) method starts by searching all fragments 
that are currently attached to the activity If it can find no fragment with 
the correct tag, it then searches through all fragments on the back stack. 

By giving all fragments the same tag of "visible_ fragment", the 
above code will get a reference to the fragment that’s currently attached to 
the activity 

Here’s the full code for the OnBackStackListener. We’re using the 
f indFragmentByTag ( ) method to get a reference to the currently 
attached fragment. We’re then checking which type of fragment it’s an 
instance of so we can work out the value of currentPosition: 

getFragmentManager () . addOnBackStackChangedListener ( 



FragmentManager fragMan = getFragmentManager () ; 

Fragment fragment = fragMan . f indFragmentByTag ( M visible_fragment" ) ; 
if (fragment instanceof TopFragment) { 



new FragmentManager . OnBackStackChangedListener 
public void onBackStackChanged ( ) { 




} 



currentPosition = 0 ; 



^ — Cheek what type ot tva^ent it is, 
and set tu'rventP osition atdovdm^ly- 



if (fragment instanceof PizzaFragment) { 
currentPosition = 1; 



□ 



} 



BitsAndPizzas 



if (fragment instanceof PastaFragment) { 
currentPosition = 2 ; 




app/sre/main 




} 



if (fragment instanceof Stores Fragment) { 
currentPosition = 3; 



} 

setActionBarTitle (currentPosition) ; 

drawerList . setltemChecked (currentPosition , true) ; 



com.hfad.bitsandpizzas 





MainActivity.java 



Sci ihc action ba\r title and highlight "the 
Comet item in the drawer Listl/iew. 



That’s all the code we need to get our action bar titles to sync with the 
displayed fragment when the user clicks on the Back button. Before we see 
it running, let’s look at the full code for MainActivity.java. 
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navigation drawers 



The full MainActivityjava code 

Here’s the entire code for MainActivity.java : 
package com. hfad. bitsandpizzas; 

VVcVc usin<^ 

fVa^mentAlana^e*" dlass, so 

import android, app .Activity; ^ ^ ^ - |m?or t it. 
import android . app . Fragment; ^ 

import android . app . FragmentManager ; 

import android . app . FragmentTransaction; 
import android . content . Intent ; 
import android . content . res . Configuration; 
import android . os . Bundle; 

import android . support . v7 . app . ActionBarDrawerToggle ; 



□ 

Bits And Pizzas 
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app/src/main 

4U 

java_ 
com. hfad. bi tsand pizzas 



MainActivity.java 









import android. view. Menu; 
import android . view . Menultem; 
import android . view .View; 
import android . widget . AdapterView; 
import android . widget . ArrayAdapter ; 
import android . widget . ListView; 
import android . widget . ShareActionProvider; 
import android . support . v4 . widget . DrawerLayout ; 



These ave all the classes used in the Code- 



public class MainActivity extends Activity { 



private ShareActionProvider ShareActionProvider; 
private String [] titles; 
private ListView drawerList; 
private DrawerLayout drawerLayout ; 
private ActionBarDrawerToggle drawerToggle; y he 0*|t e mCliekListener's onltemCliCkO 

private int currentPosition = 0 ; method jets Called when the user clicks 

«* an item in the drawers ListView. 

private class DrawerltemClickListener implements ListView . OnltemClickListener { 
QOverride 

public void onltemClick (AdapterView<?> parent, View view, int position, long id) { 
//Code to run when an item in the navigation drawer gets clicked 
selectltem (position) ; — - 

I Call the seledtltemO method when an The dode dontinues ' 

^ 'tem in the drawer Listl/iew is clicked- on the ne*t paje 



\ , , 

^ We re usmj all these private variables. 



you are here ► 



429 



MainActivity code 



MainActivity .java (continued) 



□ 



Bits And Pizzas 



QOverride 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_main) ; 

titles = getResources (). getStringArray (R. array . titles) ; 
drawerList = (ListView) findViewByld (R . id . drawer ) ; 
drawerLayout = (DrawerLayout) findViewByld (R . id . drawer_layout) ; 
//Initialize the ListView 

drawerList . setAdapter (new ArrayAdapter<String> (this, 

android. R. layout . simple_list_item_activated_l , titles) ) ; 
drawerList . setOnltemClickListener (new DrawerltemClickListener ( ) ) 

//Display the correct fragment, 
if (savedlnstanceState != null) { 

currentPosition = savedlnstanceState . getlnt ( "position" ) ; 
setActionBarTitle (currentPosition) 

} else { 

selectltem(O) ; ^ is ?' a 7 Toffrajmeivt 

by de-raw lx- 

//Create the ActionBarDrawerToggle 

drawerToggle = new ActionBarDrawerToggle (this , drawerLayout, 

R. string . open_drawer, R . string . close_drawer) { 



4T3 

app/src/main 

HB 



java 
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com. hfad.bitsand pizzas 



MainActivity.java 

Populate tbe 
drawer s ListView 
and yt it to 
respond to elieks. 



It tbe activity's been destroyed and re- 
created, set the Correct action bar title. 



//Called when a drawer has settled in a completely closed state 
QOverride 



public void onDrawerClosed (View view) { 
super . onDrawerClosed (view) ; 

invalidateOptionsMenu ( ) ; Call invalidateOptionsMenu when tbe drawer is 

I °P Ch oy * because we want to change tbe 

f action iterwS displayed in tbe action bar. 

//Called when a drawer has settled in a completely open state. 
@Override 



public void onDrawerOpened (View drawerView) { 
super . onDrawerOpened (drawerView) ; 
invalidateOptionsMenu ( ) ; 

} Tbe Code Continues 

on tbe next pay. 
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MainActivity.java (continued) 



This Code is still part of the onCreateO method 

drawerLayout . setDrawerListener (drawerToggle) ; 
getActionBar ( ) . setDisplayHomeAsUpEnabled ( true ) ; 

getActionBar ( ) . setHomeButtonEnabled (true) ; Enable the Up idoK ok the adtioK bav 

so we dan use it to open the drawer. 
getFragmentManager () . addOnBackStackChangedListener ( 

new FragmentManager . OnBackStackChangedListener () { 



public void onBackStackChanged () { 




FragmentManager fragMan = getFragmentManager () ; 

Fragment fragment = fragMan . findFragmentByTag ( "visible_fragment" ) ; 
if (fragment instanceof TopFragment) { 
currentPosition = 0 ; 



if (fragment instanceof PizzaFragment) 
currentPosition = 1 ; 

} 



This yts called 
wheK the badk 
stadk dhaKys. 



Chedk whidh dlass 
the -PiragmeKt 
duinrehtly attadhed 
to the adtivity is 

aK ihstaKde o-P, ay\d (fragment instanceof PastaFragment) { 

set dumrehtPositioh currentPosition = 2 ; 

addoirdih^ly. \ j 

if (fragment instanceof Stores Fragment) { 
currentPosition = 3; 

} 

setActionBarTitle (currentPosition) ; 

drawerList . setltemChecked (currentPosition , true) 

> ^ 

} Set -the adtion bar -title and hi^hli^ht the 

> dorredt item in the drawer Listl/iew- 



□ 

BitsAndPizzas 

HH 

app/sre/main 

L a 



java 



4U 



com.hfad.bitsandpizzas 



MainActivity.java 



The dodc doKt'mues 
ok the Ke*t pay. 
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more MainActivity code 



MainActivity .java (continued) 



We call -the seleetltemO »ethod when -the <»sev 
elitb on an item in the dnawen s List\Aew. 

private void selectltem (int position) { 

// update the main content by replacing fragments 

currentPosition = position; 

Fragment fragment; 
switch (position) { 
case 1 : 



fragment 

break; 



new PizzaFragment () ; 



case 2 : 



□ 

BitsAndPizzas 

4H 

app/src/main 

4B 
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com. hfad.bitsand pizzas 



MainActivity.java 



fragment 
break; 
case 3 : 



new PastaFragment () ; 




Decide which -fragment to display 
based on -the position o( the item the 
usev - selects in the drawees Listl/iew. 



fragment = new StoresFragment ( ) ; 
break; 
default : 

fragment = new TopFragment ( ) ; Display 'Pvajw'Cnt 

} ^ 

FragmentTransaction ft = getFragmentManager ( ) . beginTransaction ( ) ; 
ft . replace (R. id. content_f rame, fragment, "visible_f ragment" ) ; 
f t . addToBackStack (null ) ; 

ft . setTransition (FragmentTransaction . TRAN S I T_FRAGMENT_FADE ) ; 
ft . commit ( ) ; 

//Set the action bar title 

setActionBarTitle (position) ; Display the night title in “the action bav*. 

//Close the drawer 

drawerLayout . closeDrawer (drawerList) ; 

Close *tbe dv-awev. 
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Tbe Code Continues 

on •bbe ne%*b pay- 



navigation drawers 



MainActivity.java (continued) 

@Override 

public boolean onPrepareOptionsMenu (Menu menu) { 

// If the drawer is open, hide action items related to the content view 
boolean drawerOpen = drawerLayout . isDrawerOpen (drawerList) ; 
menu . f indltem (R. id. action_share) . setVisible ( ! drawerOpen) ; 

return super . onPrepareOptionsMenu (menu) ; p isp | a y £have action if the drawer is 

} dosed, hide it it the draw is open- 

@Override 

protected void onPostCreate (Bundle savedlnstanceState) { 
super . onPostCreate (savedlnstanceState) ; 

// Sync the toggle state after onRestorelnstanceState has occurred. 

drawerToggle . syncState ( ) ; ^ state of the AdtionBarPrawerToggle 

} with the state of the drawer- 



@Override 

public void onConf igurationChanged (Configuration newConfig) { 
super . onConf igurationChanged (newConfig) ; 
drawerToggle . onConf igurationChanged (newConfig) ; 

} p ass ^tails of a«y Configuration changes 



to the AAionBarprawer Toggle 

@ Override 

public void onSavelnstanceState (Bundle outState) { 
super . onSave Instance State (outState) ; 
outState . putlnt ( "position" , currentPosition) ; 



□ 

Pizz 

MO 



Bits And Pizzas 



} 



^ Save "the state of euvventPosition i-P -the aeti vity^s destroyed- 



app/sre/main 

HU 

java 

MO 

com . hfad . bitsand pizzas 



private void setActionBarTitle (int position) { 

String title; 
if (position == 0) { 

title = getResources (). getString (R. string . app_name) ; 

} else { 

title = titles [position] ; 

J Set *tV>e aetio* bav title so it 

getActionBar () . setTitle (title) ; ^ . ve-fledts tbe -fv-ajment that’s 

} displayed- 



MainActivity.java 



Tbe £ode fcontmues 
OY\ •the ne*t page- 
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nearly there 



MainActivity.java (continued) 



@Override 



Add items m tbe menu resource 
-file -to -the action bar- 



public boolean onCreateOptionsMenu (Menu menu) { 

// Inflate the menu; this adds items to the action bar if it is present. 
getMenuInf later ( ) . inf late (R . menu . menu_main, menu); 

Menultem menultem = menu . f indltem (R . id . action_share ) ; 

shareActionProvider = ( ShareActionProvider ) menultem. getActionProvider () ; 
setlntent ( "This is example text"); 
return super . onCreateOptionsMenu (menu) ; 



} 



Pass "the Shave action an nvtcrrt *C ov i-fc, "to shave- 



□ 

BitsAndPizzas 



private void setlntent (String text) { 

Intent intent = new Intent ( Intent . ACTION_SEND) ; 
intent . setType ( "text /plain" ) ; 
intent . putExtra ( Intent . EXTRA_TEXT, text) ; 
shareActionProvider . setShareintent (intent) ; 



40 

app/sre/main 

40 

java_ 

mo 



This method is tailed when the usev 
^ tlitks on an item in the adtion bav- 

@Override 

public boolean onOptionsItemSelected (Menultem item) 
if (drawerToggle . onOptionsItemSelected (item) ) { 

return true; 



com.hfad.bitsandpizzas 



MainActivity.java 



^ If -the ActionBar Drawer Toggle is clicked, lei it handle what happens. 



switch (item. getltemld ( ) ) { 

case R. id. action_create_order : 

//Code to run when the Create Order item is clicked 
Intent intent = new Intent (this, OrderActivity . class ) ; 
startActivity (intent) ; Create Order action is 

return true; clicked, start OrderActivity- 

case R. id. action_settings : 

//Code to run when the settings item is clicked 
return true; 
default : 

return super . onOptionsItemSelected ( item) ; 



} 



} 



434 Chapter 10 



navigation drawers 



Test drive the app 

Let’s see what happens when we run the app. 







n 



= Pizzas 



Diavolo 



Funghi 

you di£.k oy\ "the Pizzas 
option, Pizzasprajment is 
displayed and the action bav- 
title is £han<jed to "Pizzas”. 




When you click on the back button, the previously selected 
fragment is displayed and the action bar title stays in sync. The 
action bar title also stays in sync when you rotate the device. 
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CHAPTER 10 



toolbox 




You’ve got Chapter 10 under 
your belt and now you’ve 
added drawer layouts to your 



Your Android Toolbox 



You tan download 
i he -full todt -for 
i\\t from 



HcadPivstA^dvoid- 



toolbox. 




BULLET POINTS 



■ Use a DrawerLayout to create an activity with a navigation 
drawer. Use the drawer to navigate to the major hubs of your app. 

■ If you’re using an action bar, use ActionBarDrawerToggle 
as a DrawerListener. This allows you to respond to the 
drawer opening and closing, and adds an icon to the action bar for 
opening and closing the drawer. 

■ To change action bar items at runtime, call 

invalidateOptionsMenu ( ) and add the changes in the 
activity’s onPrepareOptionsMenu ( ) method. 

■ React to changes on the back stack by 
implementing the FragmentManager . 
OnBackStackChangedListener () . 

■ The fragment manager’s f indFragmentByTag ( ) method 
searches for fragments with a given tag. 
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11 SQLlte dcttakases 







Up the Database + 




When I said I 
wanted persistence, 
I was talking about 
the database. 






If you’re recording high scores or saving tweets, your app will 
need to store data. And on Android you usually keep your data safe inside a 
SQLite database. In this chapter, we ll show you how to create a database, add tables 
to it, and prepopulate it with data, all with the help of the friendly SQLite helper. You’ll 
then see how you can cleanly roll out upgrades to your database structure, and how to 
downgrade it if you need to pull any changes. 



this is a new chapter 
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Starbuzz again 



Pack to Starbuzz 

Back in Chapter 6, we created an app for Starbuzz. The app 
allows users to navigate through a series of screens so that 
they can see the drinks available at Starbuzz. 



Sfarfeurz 
«rc of fee 



Drinks 

Food 




Stores 



The -top-level 
afrtivi-ty displays a 
list ot options. 



+ A u 10:26 




_atte 

A couple of espresso shots with steamed milk 



o 

V 










□ 

o 

V 







you tlidk ok 
a dv-’mk, its details 
ave displayed- 



The Starbuzz database gets its drink data from a Drink class 
containing a selection of drinks available at Starbuzz. While 
this made building the first version of the app easier, there’s a 
better way of storing and persisting data. 

Over the next two chapters, we’re going to change the 
Starbuzz database so that it gets its data from a SQLite 
database. In this chapter, we’ll see how to create the database, 
and in the next chapter, we’ll show you how to connect 
activities to it. 
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SQLite databases 



Android uses SQLite databases to persist data 



All apps need to store data, and the main way you do that in Androidville 
is with a SQLite database. Why SQLite? 



o 

o 

© 



It's lightweight. 

Most database systems need a special database server process 
in order to work. SQLite doesn’t, a SQLite database is just a 
file. When you’re not using the database, it doesn’t use up any 
processor time. That’s important on a mobile device, because 
we don’t want to drain the battery. 

It's optimized for a single user. 

Our app is the only thing that will talk to the database, so 
we shouldn’t have to identify ourselves with a username and 
password. 

It's stable and fast. 

SQLite databases are amazingly stable. They can handle 
database transactions, which means if you’re updating several 
pieces of data and screw up, SQLite can roll the data back. 
Also, the code that reads and writes the data is written in 
optimized G code. Not only is it fast, but it also reduces the 
amount of processor power it needs. 



Were going to go 
through the basics ol 
SQLite in this chapter. 

II you plan on doing a 
lot ol database heavy 
lilting in your apps, we 
suggest you do more 
background reading on 

SQLite and SQL. 



Where's the database stored? 



Android automatically creates a folder for each app where the app’s 
database can be stored. When we create a database for the Starbuzz app, 



it will be stored in the following folder: 






■ tor* 



btad sta'rkwzi is Ibe app's w>i«\i»e iden-titie*-- 



/ data/ data/ com. hfad. starbuzz/ databases 



An app can store several databases in this folder. Each database 
consists of two files. 

The first file is the database file and has the same name 
as your database — for example, “starbuzz”. This is the main 
SQLite database file. All of your data is stored in this file. 

The second file is the journal file. It has the same name 
as your database, with a suffix of “-journal” — for example, 
“starbuzz-journal”. The journal file contains all of the changes 
made to your database. If there’s a problem, Android will use 
the journal to undo (or rollback) your latest changes. 




This is -the database 



•Pile. -> 




starbuzz 



This is the journal 




starbuzz-journal 
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your new best friends 



Android comes with SQlite classes 

Android uses a set of classes that allows you to manage a 
SQLite database. There are three types of object that do the 
bulk of this work. 




The SQlite Helper 



You create a SQLite 
helper by extending the 
SQLiteOpenHelper 
class. This enables you 
to create and manage 
databases. 



The SQlite database 

The SQLiteDatabase 
class gives you access to 
the database. It’s like a 
SQLConnection in JDBC. 



Cursors 



A Cursor lets you 
read from and write to 
the database. It’s like a 
ResultSet in JDBC. 




We’re going to use these objects to show you how to create a 
SQLite database your app can use to persist data by replacing 
the Drink class with a SQLite database. 



there-iStre no 

Dumb Questions 



Q? If there's no username and 
password on the database, how is it 
kept secure? 



The directory where an app’s 
databases are stored is only readable by 
the app itself. The database is secured 
down at the operating system level. 



% Can I write an Android app that 
talks to some other kind of external 
database, such as Oracle? 



There’s no reason why you can’t 
access other databases over a network 
connection, but be careful to conserve 
the resources used by Android. For 
example, you might use less battery power 
if you access your database via a web 
service. That way, if you’re not talking to 
the database, you're not using up any 
resources. 



% Why doesn’t Android use JDBC to 
access SQLite databases? 



We know we’re going to be using a 
SQLite database, so using JDBC would be 
overkill. Those layers of database drivers 
that make JDBC so flexible would just drain 
the battery on an Android device. 



Is the database directory inside 
the app’s directory? 



^Z No. It’s kept in a separate directory 
from the app’s code. That way, the app can 
be overwritten with a newer version, but 
the data in the database will be kept safe. 
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The current Starbuzz app structure 

Here’s a reminder of the current structure of the Starbuzz app: 



o 

o 



TopLevel Activity contains a list of options for 
Drinks, Food, and Stores. 

When the user clicks on the Drinks option, it 
launches DrinkCategoryActivity. 

This activity displays a list of drinks that it gets from the 
Java Drink class. 



© 



When the user clicks on a drink, its details get 
displayed in DrinkActivity. 



DrinkActivity gets details of the drink from the Java 
Drink class. 



The app duv-vently $ets its 
data *fvom the dlass. 




activity_top_level.xml 





Drink.java 



activity_drink.xml 



DrinkCategoryActivity.java 



DrinkActivity.java 



How does the app structure need to change if we’re to use a 
SQLite database? 




We’re going to update the 
Starbuzz app in this chapter, 
so open your original Starbuzz 
project in Android Studio. 
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change app 



Well change the app to use a database 

We’ll use a SQLite helper to create a SQLite database we can use with 
our Starbuzz app. We’re going to replace our Drink Java class with a 
database, so we need our SQLite helper to do the following: 



© 



Create the database. 

Before we can do anything else, we need to get the SQLite helper to create 
version 1 (the first version) of our Starbuzz database. 



Q 



Create the Drink table and populate it with drinks. 

Once we have a database, we can create a table in it. The table structure 
needs to reflect the attributes in the current Drink class, so it needs to be 
able to store the name, description, and image resource ID of each drink. 
We’ll then add three drinks to it. 



The app has the same structure as before except that we’re replacing 
the file Drink.java with a SQLite helper and a SQLite Starbuzz 
database. The SQLite helper will maintain the Starbuzz database, and 
provide access to it for the other activities. We’ll change the activities 
to use the database in the next chapter. 






Well st ore drinks in a 
database rather the 
Drink elass. 



<Layou-t> I 
</Layou-t> I 

activity_top_level.xml 




Starbuzz 

database 




SQLite Helper 



activity_drink.xml 




Device 



TopLevel Activity .java 



DrinkCategoryActivity.java 




DrinkActivity.java 



Let’s start by looking at the SQLite helper. 



In the next chapter, well change 
the activities that access the Drink 
class so that they use the database 
instead- 
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SQLite databases 



The SQLite helper manages your database 

The SQLiteOpenHelper class is there to help you create 
and maintain your SQLite databases. Think of it as a personal 
assistant who’s there to take care of the general database 
housekeeping. 

Let’s look at some typical tasks that the SQLite helper can assist 
you with: 



Create database 
Create table 



Creating the 
database 



When you first install 
an app, the database file 
won’t exist. The SQLite 
helper will make sure the 
database file is created 
with the correct name 
and with the correct table 
structures installed. 




The SQLite helper 



i 



Keeping the database shipshape 



(retting access to 
the database 

Our app shouldn’t 
need to know all of the 
details about where 
the database file is, so 
the SQLite helper can 
serve us with an easy- 
to-use database object 
whenever we need it. At 
all hours, day or night. 



The structure of the database will probably 
change over time, and the SQLite helper can 
be relied upon to convert an old version of a 
database into a shiny, spiffy new version, with 
all the latest database structures it needs. 
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create helper 



Create database 
Create table 



Create the SQUte helper 

You create a SQLite helper by writing a class that extends the 
SQLiteOpenHelper class. When you do this, you must override 
the onCreate ( ) and onUpgrade ( ) methods. These methods are 
mandatory. 

The onCreate () method gets called when the database first gets 
created on the device. The method should include all the code 
needed to create the tables you need for your app. 

The onUpgrade ( ) method gets called when the database needs to 
be upgraded. As an example, if you need to make table changes to 
your database after it’s been released, this is the method to do it in. 

In our app, we’re going to use a SQLite helper called 
StarbuzzDatabaseHelper. Create this class in your Starbuzz 
project by highlighting the app /src/main/java/com.hf ad. starbuzz folder 
in your project folder explorer, and navigating to File— >New...— Java 
Class. Give the class a name of “StarbuzzDatabaseHelper”, then 
replace its contents with the code below: 



package com . hf ad . starbuzz ; 





T 

The S^IrteOpenttelper dass is a 
subclass o( Object- 



import android . database . sqlite . SQLiteOpenHelper ; 

import android . content . Context ; 

import android . database . sqlite . SQLiteDatabase ; 



S^L'rte helpers mus*t e**teir>di 
■the SQUteOpenttelpet dlass. 



/ 



class StarbuzzDatabaseHelper extends SQLiteOpenHelper { 



{ 



□ 

Starbuzz 



HU 

app/sre/main 

HD 



java 



StarbuzzDatabaseHelper (Context context) 

} 

laVv. 

mil 

@Override . 

com . hfad .starbuzz 

public void onCreate (SQLiteDatabase db) { LQ 

The onCteateO and onWpgtadeO methods ate O 

mandatoty. We've lett them empty tot no*, and we'll starbuzzDatabase 
■them \v\ more detail ■throujjhou'i "the £hdp”ter. 

public void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) { 

} 



} 



@ Override 



Helper.java 



To get the SQLite helper to do something, we need to add code to its 
methods. The first thing to do is tell the SQLite helper what database 
it needs to create. 
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1. Specify the database 



There are two pieces of information the SQLite helper needs in 
order to create the database. 



First, we need to give the database a name. By giving the database 
a name, we make sure that the database remains on the device 
when it’s closed. If we don’t, the database will only be created in 
memory, so once the database is closed, it will disappear. 

The second piece of information we need to provide is the version 
of the database. The database version needs to be an integer 
value, starting at 1. The SQLite helper uses this version number to 
determine whether the database needs to be upgraded. 

You specify the database name and version by passing them to the 
constructor of the SQLiteOpenHelper superclass. We’re going 
to give our database a name of “starbuzz”, and as it’s the first 
version of the database, we’ll give it a version number of 1. Here’s 
the code we need (update your version of StarbuzzDatabaseHelper. 
java with the code below): 



Greatm^ databases that are o*ly 
^ held m memory LZ* be useful when 
youre testing y our app* 



SQLite database 



Name: "starbuzz" 
Version: 1 



class StarbuzzDatabaseHelper extends SQLiteOpenHelper { 



private static final String DB_NAME = "starbuzz”; // the name of our database 
private static final int DB_VERSION =1; // the version of the database 



StarbuzzDatabaseHelper (Context context) { tVeVe dallm^ “tbc dons'trud'tor o£ *tbc 

super (context, DB_HAME, null, DB_VERSION) ; K S^LiteOpenttelfer sufettlass, and passmj 

1 nr T , 

I his parameter is am advanced -feature relating to 
Cursors. Were Covering Cursors in the next chapter. 



it ihe database name and version. 

□ 



t—w—w 



The constructor specifies details of the database, but the database 
doesn’t get created at that point. The SQLite helper waits until the 
app needs to access the database, and the database gets created at 
that point. 



KJ 

app/sre/main 

4ZJ 

java_ 

LQ 



Once you’ve told the SQLite helper what database to create, you 
can specify its tables. 



com. hfad. starbuzz 




StarbuzzDatabase 

Helper.java 



you are here ► 
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tables 



Inside a SQLite database 



Wc vc &ot\t cvcv-yih'mj we need b> gei s. v 
■the database Seated v/ben we need it* 



Create database 
Create table 



The data inside a SQLite database is stored in tables. A table contains 
several rows, and each row is split into columns. A column contains a single 
piece of data, like a number of a piece of text. 

You need to create a table for each distinct piece of data that you want to 
record. In the Starbuzz app, for example, we’ll need to create a table for the 
drink data. It will look something like this: 



The dolumns in *thc "tdble 3vc 

jd, NAME, DESCRIPTION, and 
IMA^RKOMRCEJD. The 

Dv-ink dlass don'lained similarly 
named attributes. 

\£ 



_id 


NAME 


DESCRIPTION 


IMAGE.RESOURCE.ID 


1 


“Latte” 


"Espresso and steamed milk" 


54543543 


2 


“Cappuccino” 


"Espresso, hot milk and 


654334453 






steamed-milk foam" 




3 


“Filter” 


"Our best drip coffee" 


44324234 



Some columns can be specified as primary keys. A primary key uniquely 
identifies a single row. If you say that a column is a primary key, then the 
database won’t allow you to store rows with duplicate keys. 

We recommend that your tables have a single integer primary key column 
called _id. This is because Android code is hardwired to expect a numeric 
_id column, so not having one can cause you problems later on. 

Storage classes and data-types 

Each column in a table is designed to store a particular type of data. For 
example, in our DRINK table, the DESCRIPTION column will only ever 
store text data. Here are the main data types you can use in SQLite, and 
what they can store: 



INTEGER 


Any integer type 


TEXT 


Any character type 


REAL 


Any floating-point number 


NUMERIC 


Booleans, dates, and date-times 


BLOB 


Binary Large Object 



Unlike most database systems, you don’t need to specify the column size in 
SQLite. Under the hood, the data type is translated into a much broader 
storage class. This means you can say very generally what kind of data 
you’re going to store, but you’re not forced to be specific about the size of 
data. 



It’s an Android 
convention to call 
your primary key 
columns _id. Android 
code expects there to 
he an _id column on 
your data. Ignoring 
this convention will 
make it harder to get 
the data out ol your 
database and into 
your user interlace. 
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You create tables using Structured Query Language (SQL) 

Every application that talks to SQLite needs to use a standard database 
language called Structured Query Language. SQL is used by almost every 
type of database. If you want to create the DRINK table, you will need to 
do it in SQL. 

This is the SQL command to create the table: The __id dolur*m is “the pvimavy key. 

K 

CREATE TABLE DRINK (_id INTEGER PRIMARY KEY AUTO INCREMENT , 

The -table *a»>e name text , 

These are the table CoU,/> description text, 

X -'^IMAGE_RESOURCE_ID INTEGER) 



The CREATE TABLE command says what columns you want in the table, 
and what the data type is of each column. The _id column is the primary 
key of the table, and the special keyword AUTOINCREMENT means that 
when we store a new row in the table, SQLite will automatically generate a 
unique integer for it. 



The owCreateO method is called when the database is created 

The SQLite helper is in charge of creating the SQLite database the first 
time it needs to be used. Lirst, an empty database is created on the device, 
and then the SQLite helper onCreate () method is called. 

The onCreate ( ) method is passed a SQLiteDatabase object as a 
parameter. We can use this to run our SQL command with the method: 

SQLiteDatabase. execSQL (String sql) ; — E*eduie ibe S<$L m tbe 

sirmj or, -tbe database. 

This method has one parameter, the SQL you want to execute. 

Here’s the full code for the onCreate ( ) method: 



Tke 

SQLiteDatabase 
class gives you 
access to tke 
database. 



QOverride 

public void onCreate (SQLiteDatabase db) { 

db. execSQL ("CREATE TABLE DRINK (" 

+ "_id INTEGER PRIMARY KEY AUTO INCREMENT , 
+ "NAME TEXT , " 

+ "DESCRIPTION TEXT , " 

+ "IMAGE_RESOURCE_ID INTEGER);"); 



n 



□ 

Starbuzz 

4a 

app/src/main 



java_ 



com. hfad. starbuzz 




This gives us an empty DRINK table, but what if we want to prepopulate 
it with data? 



StarbuzzDatabase 

Helper.java 



you are here ► 



447 



insertQ 



Insert data using the insert!) method 




Create database 
Create table 



The SQLiteDatabase class contains several methods that enable you to insert, 
update, and delete data. We’ll look at these methods over the next few pages, 
starting with inserting data. 

If you need to prepopulate a SQLite table with data, you can use the 
SQLiteDatabase insert () method. This method allows you to insert 
data into the database, and returns the ID of the record once it’s been inserted. 
If the method is unable to insert the record, it returns a value of - 1 . 

To use the insert ( ) method, you need to specify the table you want to insert 
into, and the values you’re inserting. You say what values you want to insert by 
creating a ContentValues object. A Con tentVa lues object is used to 
hold name/value pairs of data: 

ContentValues drinkValues = new ContentValues () ; 

You add name /value pairs of data to the ContentValues object using its 
put() method. We want to use it to insert a row of data into the DRINK 
table, so we’ll populate it with the name of each column in the DRINK table, 
and the value we want to go in each field: 




T 

The £$liteDatabase dlass 
is a subclass o( Objedt. 



This will put the value 

ContentValues drinkValues = new ContentValues () ; w< - 1 , i , .1 . » . 

Espresso and steamed milk m 

drinkValues. put ("NAME", "Latte"); f the DESCRIPTION toU*. 

drinkValues .put ("DESCRIPTION" , "Espresso and steamed milk") ; 



drinkValues . put ( " IMAGE_RESOURCE_ID" , R. drawable . latte) ; you need a separate dall to 

the putO method -for eadh 

Finally, we’ll use the SQLiteDatabase insert ( ) method to insert the value You want to enter 

values into the DRINK table: 



db. insert ("DRINK", null, drinkValues); 

Running these lines of code will insert the Latte record into the DRINK table: 



_id 


NAME 


DESCRIPTION 


IMAGE_RESOURCE_ID 


1 


“Latte” 


"Espresso and steamed milk" 


54543543 



shiny new redord 

/ ^ets inserted into 

the table- 



The insert ( ) method takes the following general form: 



db . insert (String table, String nullColumnHack, ContentValues values); 



The nullColumnHack String value is optional and most of the time 
you’ll want to set it to null like we did in the code above. It’s there in case the 
ContentValues object is empty and you want to insert an empty row into 
your table. SQLite won’t let you insert an empty row without you specifying 
the name of at least one column; the nullColumnHack parameter allows 
you to specify one of the columns. 



This inserts a single row 
into the table- To insert 
multiple rows, you need 
to make repeated dal Is to 
the insertO method- 
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Update records with the update!) method 

You update existing records in SQLite using the SQLiteDatabase 
update () method. This method allows you to update records in the 
database, and returns the number of records it’s updated. To use the 
update () method, you need to specify the table you want to update 
records in, the values you want to update, and the conditions for updating 
them. Here’s what it looks like: 

public int update (String table , 

ContentValues values. 

String whereClause, 

S tr ing [ ] whereArgs ) 



As an example, here’s how you’d change the value of the DESCRIPTION 
column to “Tasty” where the name of the drink is “Latte”: 



ContentValues drinkValues = new ContentValues () ; 

drinkValues. put ("DESCRIPTION", "Tasty") ; will f>u”t tbe value “Tasty” m the DESCRIPTION Column, 

db . update ( "DRINK" , 

drinkValues, ^ Update^the DESCRIPTION £olumn to “Tasty” 

"NAME = ?", 

new String[] {"Latte"}); 



in the DRIN^ table where NAME — “Latte”. 

/ 



_id 


NAME 


DESCRIPTION 


IMAGE_RESOURCE_ID 


1 


“Latte” 


2Sj6ff? , eSKgb^ 

"Tasty" 


54543543 



The first parameter of the update ( ) method is the name of the 
table you want to update (in this case, the DRINK table). 

The second parameter specifies what values you want to update. 

Just as you did with the insert ( ) method, you say what values 
you want to update by creating a ContentValues object to hold 
name/value pairs of data: 

ContentValues drinkValues = new ContentValues () ; 
drinkValues. put ("DESCRIPTION", "Tasty") ; 

The third parameter gives conditions for which records you want 
to update. In the above example, "NAME = ? " means that the 
NAME column should be equal to some value. The ? symbol is 
a placeholder symbol for this value. The query uses the contents 
of the last parameter to say what the value should be (in this case, 
“Latte”). 

You can also specify multiple criteria, and we’ll show you this on 
the next page. 



\Lm 

U d fe I you set the 
last two 
parameters of 
Watci it! the updateO 

method to null, 
ALL records in the table 
will be updated. 



As an example, the code 

db . update ( "DRINK" , 

drinkValues , 
null, null) ; 

will update all records in the 
DRINK table. 



you are here ► 
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conditions 



Multiple conditions 




Create database 
Create table 



If you want to apply multiple conditions to your query you need to make 
sure you specify the conditions in the same order you specify the values. As an 
example, here’s how you’d update records from the DRINK table where the 
name of the drink is “Latte”, or the drink description is “Our best drip coffee”. 



db. update ("DRINK", 

drinkValues , 

"NAME = ? OR DESCRIPTION = ?", 



This means: 1/Vheve 
DESCRIPTION - 



NAME- — u Lattc w ov 
w 0uv bes-t dv ip Lo^tt ■ 



new String [] {"Latte", "Our best drip coffee"}); 



The condition values must be Strings, even if the column you’re applying the 
condition to doesn’t contain Strings. If this is the case, you need to convert 
your values to Strings. As an example, here’s how you’d return DRINK 
records where the _id is 1 : 



db . update ( " DRINK" , 

drinkValues, 
"_id = ?", 

new String [] 



Convcv-t “the in* t I 
*t o a £*brin<\ value- 

sk 

{ Integer . toS tring ( 1 ) } ) ; 



delete records with the deleteO method 



The SQLite Database delete () method works in a similar way to the 
update ( ) method you’ve just seen. It takes the following form: 

public int delete (String table. 

String whereClause, 

String [ ] whereArgs ) 

As an example, here’s how you’d delete all records from the database where 
the name of the drink is “Latte”: 



db . delete ( "DRINK" , 

"NAME = ?", 
new String [] 



Can you see how similar “this is *to “the updateO method? 



{"Latte"}) ; 



The entire row is deleted 




The first parameter is the name of the table you want to delete records from 
(in this case, DRINK). The second and third arguments allow you to describe 
conditions to specify exactly which records you wish to delete (in this case, 
where NAME = “Latte”). 

Now that you’ve seen the kinds of operations you can do to manipulate data 
in a SQLite table, you have everything that you need to create a SQLite 
database and create tables and prepoplute them with data. On the next page, 
we’ll put this into practice in our SQLite helper code. 
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The StarbuzzPatabaseHelper code 

Here’s the complete code for StarbuzzDatabaseHelper.java (update your 
code to reflect our changes): 

package com. hfad. starbuzz ; 

import android . content . ContentValues ; 

import android . content . Context ; 

import android . database . sqlite . SQLiteDatabase ; 

import android . database . sqlite . SQLiteOpenHelper ; 



V/ 

-Hv 



SQLite databases 

Create database 
Create table 



□ 

Starbuzz 

HU 

app/src/main 

L a 



java_ 

mi 

com . hfad . starbuzz 




class StarbuzzDatabaseHelper extends SQLiteOpenHelper { 



StarbuzzDatabase 

Helper.java 



private static final String DB_NAME = "starbuzz"; // the name of our database 
private static final int DB_VERSION =1; // the version of the database 






StarbuzzDatabaseHelper (Context context) { 

super (context, DB_NAME , null, DB_VERSION) ; 

} 



. Say what the database name and 

. nr n . r.i : C 



version is. |Vs the -first version o-f the 
database, so tbe version should be I • 

onGreateO gets ealled when the database -first gets treated, 

@ Override usi »9 >t to Create the table and insert data. 

public void onCreate (SQLiteDatabase db) { 

db.execSQL ("CREATE TABLE DRINK (_id INTEGER PRIMARY KEY AUTO INCREMENT , " 

+ "NAME TEXT, - Create the DRINK table- 

+ "DESCRIPTION TEXT, " 

Insert eadh + "IMAGE_RESOURCE_ID INTEGER);"); 

drink in a y insertDrink (db, "Latte", "Espresso and steamed milk", R. drawable . latte) ; 
separate row. -Rinser tDr ink (db, "Cappuccino", "Espresso, hot milk and steamed-milk foam", 

R . drawable . cappuccino) ; 

* insertDrink (db, "Filter", "Our best drip coffee", R. drawable . filter) ; 



} 



onMpgradeO gets dal led when the database needs to be 
^-upgraded- Well look at this ne*t- 



@Override 

public void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) { 

} 



private static void insertDrink (SQLiteDatabase db, String name, 

String description, int resourceld) { 
ContentValues drinkValues = new ContentValues () ; 

drinkValues . put ( "NAME" , name) ; We need to insert several 

drinkValues. put ("DESCRIPTION", description) ; drinks, so we treated a 

drinkValues . put ( " IMAGE_RESOURCE_ID " , resourceld) ; separate method to do this- 
db . insert ( "DRINK" , null , drinkValues ) ; 

} 

} 



you are here ► 
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what happens 



Create database 
Create table 



What the Sftlite helper code does 



\/ 

-Hv 



The user installs the app and launches it. 

When the app needs to access the database, the SQLite helper checks to see 
if the database already exists. 



© 



0 O 




You need a database, 
sir? Let me see if it's 
already there for you. 



SQLite helper 



If the database doesn't exist, it gets created. 

It’s given the name and version number specified in the SQLite helper. 




SQLite helper 



SQLite database 



Name: "starbuzz" 
Version: 1 



o 



When the database is created, the onCreate() method in the 
SQLite helper is called. 

It adds a DRINK table to the database, and populates it with records. 




SQLite helper 



Name: "starbuzz" 
Version: 1 
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Here's the onCreate ( ) method of a SQLiteOpenHelper 

class. Your job is to say what values have been inserted into the 
NAME and DESCRIPTION columns of the DRINKtable when the 
onCreate ( ) method has finished running. 



QOverride 

public void onCreate (SQLiteDatabase db) { 

ContentValues espresso = new ContentValues () ; 
espresso . put ( "NAME" , "Espresso" ) ; 

ContentValues americano = new ContentValues () ; 
americano . put ( "NAME", "Americano") ; 
ContentValues latte = new ContentValues () ; 
latte. put ("NAME", "Latte") ; 

ContentValues filter = new ContentValues () ; 
filter .put ("DESCRIPTION", "Filter") ; 
ContentValues mochachino = new ContentValues () ; 
mochachino . put ( "NAME" , "Mochachino") ; 



} 



db.execSQL ("CREATE TABLE DRINK (" 

+ "_id INTEGER PRIMARY KEY AUTOINCREMENT, " 
+ "NAME TEXT, " 

+ "DESCRIPTION TEXT) ; ") ; 
db . insert ( "DRINK" , null, espresso); 
db . insert ( "DRINK" , null, americano); 
db . delete ( "DRINK" , null, null); 



db . insert ( "DRINK" , null, latte); 



db . update ( "DRINK" , mochachino, "NAME = ?", new String [] {"Espresso"}); 
db . insert ( "DRINK" , null, filter); 



need to 

the 

value o( -the 
id dolufoh. 



_id 


NAME 


DESCRIPTION 
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sharpen solution 




Here's the onCreate ( ) method of a SQLiteOpenHelper 

class. Your job is to say what values have been inserted into the 
NAME and DESCRIPTION columns of the DRINKtable when the 
onCreate ( ) method has finished running. 



QOverride 

public void onCreate (SQLiteDatabase db) { 

ContentValues espresso = new ContentValues () ; 
espresso . put ( "NAME" , "Espresso" ) ; 

ContentValues americano = new ContentValues () ; 
americano . put ( "NAME", "Americano") ; 
ContentValues latte = new ContentValues () ; 
latte. put ("NAME", "Latte") ; 

ContentValues filter = new ContentValues () ; 
filter .put ("DESCRIPTION", "Filter") ; 



} 



ContentValues mochachino = new ContentValues () ; 
mochachino . put ( "NAME" , "Mochachino") ; 

Create the table, adding Jd, 

db.execSQL ("CREATE TABLE DRINK (" ^ UhMfct DESCRIPTION Columns. 

+ "_id INTEGER PRIMARY KEY AUTOINCREMENT, " 

+ "NAME TEXT, " 

+ "DESCRIPTION TEXT) ; ") ; 

db. insert ("DRINK", null, espresso) ; l*^^ Espresso in the NAME dolumn 

null, americano) ; ^ l*^sev*t An'erieano in the NAME £olumn- 
null, null) ; ^“Delete all the drinks, 
null, latte) ; Insert Latte in the NAME £olumn- 

mochachino, "NAME = ?", new String [] {"Espresso"}); 

null, filter) ; Set NAME to Modhaeh’mo where NAME 



db. insert ("DRINK" 
db. delete ("DRINK" 
db. insert ("DRINK" 
db. update ("DRINK" 



db. insert ("DRINK" 

Insert Filter in the DESCRIPTION £olur»n- 



is Fspresso- No records ^et updated- 



_id 


NAME 


DESCRIPTION 




Latte 








Filter 
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What if you need to change the database? 

So far, you’ve seen how to create a SQLite database that your app will 
be able to use to persist data. But what if you need to make changes to 
the database at some future stage? 

As an example, suppose lots of users have already installed your 
Starbuzz app on their devices, and you want to a add a new 
FAVORITE column to the DRINK table. How would you distribute 
this change to new and existing users? 




Well, we could change the CREATE TABLE 
statement in the onCreate() method, but 
that doesn't feel entirely right to me. I 
mean, what if a device already has the old 
version of the database installed? 



When you need to change an app’s database, 
there are two key scenarios you have to deal with. 

The first scenario is that the user has never installed your app before, 
and doesn’t have the database installed on her device. In this case, 
the SQLite helper creates the database the first time the database 
needs to be accessed, and runs its onCreate ( ) method. 

The second scenario is where the user installs a new version of your 
app which includes a different version of the database. If the SQLite 
helper spots that the database that’s installed is out of date, it will call 
either the onUpgrade ( ) or onDowngrade ( ) method. 

So how can the SQLite helper tell if the database is out of date? 



you are here ► 
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version numbers 



Upgrade database 



SQLite databases have a version number 



The SQLite helper can tell whether the SQLite database needs updating 
by looking at its version number. You specify the version of the database 
in the SQLite helper by passing it to the SQLiteOpenHelper 
superclass in its constructor. 

Earlier on, we specified the version number of the database like this: 



private static final String DB_NAME = "starbuzz"; 

private static final int DB_VERSION = 1; 

StarbuzzDatabaseHelper (Context context) { 

super (context, DB_NAME , null, DB_VERSION) ; 

} 



When the database gets created, its version number gets set to the version 
number in the SQLite helper, and the SQLite helper onCreate ( ) 
method gets called. 

When you want to update the database, you change the version number 
in the SQLite helper code. To upgrade the database, specify a number 
that’s larger than you had before, and to downgrade your database, specify 
a number that’s lower: 




Geejc BifS i 



SQLite databases support 
a version number that's 
used by the SQLite helper, 
and an internal schema 
version. Whenever a 
change is made to the 
database schema, such 
as the table structure, 
the database increments 
the schema version by 1 . 
You have no control over 
this value, it's just used 
internally by SQLite. 



private static final int DB_VERSION = 2, 



WtYt 



we \re ihdveasihg -the vevsioh humbev, 



so tbe database will get upgraded 



Most of the time, you’ll want to upgrade the database, so specify a 
number that’s larger. This is because you usually only downgrade your 
database when you want to pull changes you made in a previous upgrade. 

When the user installs the latest version of the app on her device, the 
first time the app needs to use the database, the SQLite helper checks its 
version number against that of the database on the device. 

If the version number in the SQLite helper code is higher than that 
of the database, it calls the SQLite helper onUpgrade ( ) method. If 
the version number in the SQLite helper code is lower than that of the 
database, it calls the onDowngrade ( ) method instead. 

Once it’s called either of these methods, it changes the version number of 
the database to match the version number in the SQLite helper. 
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Upgrading the database: an overview 

Here’s what happens when you release a new version of the app 
where you’ve changed the SQLite helper version number from 1 to 2: 

Q) The user installs the new release of the app and runs it. 




User 



Device 



Q 



© 



If this is the first time the user has installed the app, the database 
doesn't exist, so the SQLite helper creates it. 

The SQLite helper gives the database the name and version number specified in the 
SQLite helper code. 




Name: "s+arbuzz" 

Version: 2 

The £$Lite helfev <yves the 
database a version number 
o( 2- i-f this is the version 
number spedi-fied in the 
SQLite helper dode- 



When the database is created, the onCreate() method in the SQLite 
helper is called. 

The onCreate () method includes code to populate the database. 



onCreate() 




SQLite helper 



Name: "starbuzz" 
Version: 2 
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what happens 



The story continues... 



O 



If the user installed a previous version of the app and accessed the 
database, the database already exists. 

If the database already exists, the SQLite helper doesn’t re-create it. 




SQLite helper 



DRINK 




SQLite database 



Name: "starbuzz" 
Version: 1 



o 



The SQLite helper checks the version number of the database against 
the version number in the SQLite helper code. 

If the SQLite helper version number is higher than the database version, it calls 
the onUpgrade ( ) method. If the SQLite helper version number is lower than the 
database version, it calls the onDowngrade ( ) method. It then changes the database 
version number to reflect the version number in the SQLite helper code. 




DRINK 




SQLite database 



Name: "starbuzz" 

Version!^ 2 

T 

The £$Lite helper runs -the 
onUpjjradeO method (i*P the new 
version number is higher) and 
updates the database version 
number- 
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How the SQLite helper makes decisions 

Here’s a summary of what the SQLite helper does 
depending on whether the database already exists and the 
version number of the database. 




database 
doesn't exist 




©I 



Create Database 



1 



Call onCreate() 



I 




Patabase created 





SQLite helper 
version = 
database 
version 



SQLite helper j 
version > 
database 
version 



Call onUpgrade() 



/ 




Patabase 

upgraded 




SQLite helper 
version < 
database 
version 

Call onDowngrade() 



V 




Patabase 

downgraded 
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If the database doesn't already 
exist, the SQLite helper creates 
the database, and the helper 
onCreateQ method runs. 



© 



If the database already exists, 
the SQIite helper checks the 
version number held on the 
database with the version 
number in the helper. 



© 



If the version number in the 
SQLite helper is larger than 
the version number held on 
the database, the onUpgrade() 
method is called. 

The SQIite helper then updates the 
database version number. 



o 



If the version number in the 
SQLite helper is smaller than 
the version number held on the 
database, the onDowngrade() 
method is called. 

The SQIite helper then updates the 
database version number. 



© 



If the version number in the 
SQLite helper is the same as 
the version number held on the 
database, neither method is 
called. 

The database is already up to date. 



Now that you’ve seen under what circumstances the 
onUpgrade ( ) and onDowngrade ( ) methods get called, 
let’s find out more about how you use them. 
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Upgrade database 



Upgrade your database with onUpgradeO 



The onUpgrade ( ) method has three parameters — the 
SQLite database, the version number of the database itself, 
and the new version of the database that’s passed to the 
SQLiteOpenHelper superclass: The Current version 

©t -the database 

@ Override 



The new version 
described in the 
£$|ite heifer dode 



public void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) 



//Your code goes here 

} 

The version numbers are important, as you can use them to say 
what database changes should be made depending on which 
version of the database the user already has. As an example, 
suppose you needed to run code when the database is currently at 
version 1 . Your code would look like this: 



(R -r 

Remember, -to uyyade -tbe 
da-tabase, tbe new version must 
be bibber than -tbe old version. 



{ 



QOverride 

public void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) { 

if (oldVersion == 1) { _ 

, -i This Co &z w'H only run it the 

//Code to run if the database version is 1 ^ .. >111 , 

users database is at version /. 

} 

} 



You can also use the version numbers to apply successive updates 
like this: 



QOverride 



public void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) { 

if (oldVersion == 1) { 

//Code to run if the database version is 1 ^ — "This £ode will only run it “the 
. users database is at version I. 



if (oldVersion < 3) { 

//Code to run if the database version is 1 or 2 

} 

} 

Using this approach means that you can make sure that the user 
gets all the database changes applied that they need, irrespective 
of which version they have installed. 



This £ode will run it the 
user's database is at version I 
or Z. |t the user has version 
I ot the database, it will run 
both sets ot £ode- 



The on Down grade ( ) method works in a similar way to the 
onUpgrade ( ) method. Let’s take a look on the next page. 
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downgrade your database with onPowngradeO 

The onDowngrade ( ) method isn’t used as often as the 
onUpgrade ( ) method, as it’s used to revert your database to 
a previous version. This can be useful if you release a version of 
your app that includes database changes, but you then discover 
that there are bugs. The onDowngrade ( ) method allows you to 
pull the changes and set the database back to its previous version. 

Just like the onUpgrade ( ) method, the onDowngrade ( ) 
method has three parameters — the SQLite database you 
want to downgrade, the version number of the database 
itself, and the new version of the database that’s passed to the 
SQLiteOpenHelper superclass: 

@ Override 

public void onDowngrade (SQLiteDatabase db, int 
//Your code goes here 

} 

Just as with the onUpgrade ( ) method, you can use the version 
numbers to revert changes specific to a particular version. As an 
example, if you needed to make changes to the database when 
the database version number is 3, you’d use code like following: 

QOverride 

public void onDowngrade ( SQLiteDatabase db, int oldVersion, int newVersion) { 

if 

} 

} 

Let’s put this into practice by upgrading the database. 



(oldVersion == 3) { 

//Code to run if the database version is 3 



.This £ode will run i-P “the 
has vers ion 3 o£ the database, 
but you want to downgrade it 






oldVersion, int newVersion) { 

'K f 

To downgrade the database, 
the new version must be lower 
than the old version. 



you are here ► 



461 



upgrade the database 



Upgrade database 



Let's upgrade the database 

Suppose we need to upgrade our database to add a new column to the DRINK 
table. As we want all new and existing users to get this change, we need to 
make sure that it’s included in both the onCreate ( ) and onUpgrade ( ) 
methods. The onCreate () method will make sure that all new users get the 
new column, and the onUpgrade ( ) method will make sure that all existing 
users get it too. 

Rather than put similar code in both the onCreate () and onUpgrade ( ) 
methods, we’re going to create a separate updateMyDatabase ( ) method, 
called by both the onCreate ( ) and onUpgrade ( ) methods. We’ll 
move the code that’s currently in the onCreate () method to this new 
updateMyDatabase ( ) method, and we’ll add extra code to create the extra 
column. Using this approach means that you can put all of your database code 
in one place, and more easily keep track of what changes you’ve made each 
time you’ve updated the database: 



□ 

Starbuzz 

4T3 

app/src/main 

java_ 

LQ 

com. hfad. starbuzz 

LO 



StarbuzzDatabase 

Helper.java 



@0verride 

public void onCreate (SQLiteDatabase db) { ; 

updateMyDatabase (db, 0 , DB_VERSI0N) ; < — Rather than tveate the DRIN^ table here, we II 
} <jet ouv" update MyDatabascO method to do it 



@0verride 

public void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) { 

updateMyDatabase (db, oldVersion, newVersion) ; £ — Call the updateMyDatabaseO method -Prom 
} onUpgradeO, passing along the parameters. 



private void updateMyDatabase (SQLiteDatabase db, int oldVersion, int newVersion) { 
if (oldVersion < 1) { 

/lib. execSQL ("CREATE TABLE DRINK (_id INTEGER PRIMARY KEY AUTOINCREMENT , " 
This is the + "NAME TEXT, " 

eode we + "description text, " 

had m ouv- J + "IMAGE_RES0URCE_ID INTEGER) ;") ; 

t insertDrink (db, "Latte", "Espresso and steamed milk", R. drawable . latte) ; 

insertDrink (db, "Cappuccino", "Espresso, hot milk and steamed-milk foam", 

R . drawable . cappuccino) ; 

insertDrink (db, "Filter", "Our best drip coffee", R. drawable . filter) ; 

} 

if (oldVersion < 2) { 



} 



. — This £ode will vun i*P the usev alv-eady 

//Code to add the extra column , n i\ 

has vev-sio* I ot the database- 



462 Chapter 11 



SQLite databases 




BE flie SOJjfe ReJ^et 

On the right, you’ll See some SQhite 
helper code. Your job is to play like 
you’re the SQLite helper and 
say which code will run 
for each of the users 
below. We’ve labeled 
the code we want you to 
consider. We’ve done the 
first one to start you off. 



User 1 runs the app for the first time. 

Code segment /\. The user doesn't have -the 
database, so the onCreateO method runs. 



User 2 has database version 1 . 



User 3 has database version 2. 



class MyHelper extends SQLiteOpenHelper { 

StarbuzzDatabaseHelper (Context context) { 
super (context, "fred", null, 4); 

} 



QOverride 

public void onCreate (SQLiteDatabase db) { 
^^//Run code A 



QOverride 

public void onUpgrade (SQLiteDatabase db, 

int oldVersion, 
int newVersion) { 
if (oldVersion < 2) { 

/ /Run code B 

} 

if (oldVersion == 3) { 

© / /Run code C 



} 

^^//Run code D 



User 4 has database version 3. 



User 5 has database version 4. 



User 6 has database version 5. 



QOverride 

public void onDowngrade (SQLiteDatabase db, 

int oldVersion, 
int newVersion) { 
if (oldVersion == 3) { 

//Run code E 

} 

if (oldVersion < 6) { 

0 //Run code F 

} 

} 
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BE 3QLft e HeJ^er §©]ug©n 



On the right you’ll See some SQjite 
helper code. Your job is to play like 
you’re the SQjite helper and 
say which code will run 
for each of the users 
below. We’ve labeled 
the code we want you to 
consider. We’ve done the 
first one to start you off. 



User 1 runs the app for the first time. 



class MyHelper extends SQLiteOpenHelper { 

StarbuzzDatabaseHelper (Context context) { 
super (context, "fred", null, 4); 

} ^ c 

The new version o\ 

@ Override ‘tHc dd'tsbssc is 

public void onCreate (SQLiteDatabase db) { 

©//Run code A ^“TheonCreateO method will 
only fun i-P ‘the user doesn’t 
^ have -the database. 



Code segment A- The user doesn’t have the 
database, so the onCv-eateO method funs. 

User 2 has database version 1. 

Code segment B then D- The database needs to be 
upgraded with oldVersion I- 

User 3 has database version 2. 

Code segment D- The database needs to be 
upgraded with old\/ersion 2~ 

User 4 has database version 3. 



QOverride 

public void onUpgrade (SQLiteDatabase db, 

int oldVersion, 
int newVersion) { 



if (oldVersion < 2) { 

4% / /Run code B ^This will fun i*P the 
• • • user has version I- 



} 



if (oldVersion 
® / /Run code 



== 3) { 

c <— This will VMM if -the 
usev has version 3. 



O 



} 

//Run code D^y^ Wl || ^ ^ uSCV - 

has version I, 2-, or 3- 



Code segment C then D- The database needs to be 
upgraded with oldl/ersion 3. 

User 5 has database version 4. 

None- The user has the dorredt version dr the 
database- 

User 6 has database version 5. 

Code segment F The database needs to be 
downgraded with oldVersion *5. 
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QOverride 

public void onDowngrade (SQLiteDatabase db, 

int oldVersion, 
int newVersion) { 



if (oldVersion 
//Run code 



o 



— 3) { This will never 
E run- I* P the user 

* has version 3, her 
database needs 
< 6 ) { to be upgraded, 

F not downgraded- 



} 

if (oldVersion 
//Run code 

? V, 

This will run i*P the user has version *?. ror 
onPowngradeO to run, the user must have 
a version greater than ^E as thats the 
durrent version number o- P the helper- 



Upgrading an existing database 



■*a 



SQLite databases 

Upgrade database 



When you need to upgrade your database, there are two types of actions 
you might want to perform: 



o 



Change the database records. 

Earlier on in the chapter, you saw how to insert, update, or delete records in 
your database using the SQLiteDatabase insert ( ) , update ( ) , and 
delete ( ) methods. You may add more records when you upgrade the 
database, or change or remove the records that are already there. 



o 



Change the database structure. 

You’ve already seen how you can create tables in the database. You may 
also want to add columns to existing tables, rename tables, or remove tables 
completely. 



We’ll look at how to perform these actions over the next few pages, 
starting with changing the database structure to add columns to existing 
tables. 



Add new columns to tables using SQL 



Earlier on in the chapter, you saw how you could create tables using the 
SQL CREATE TABLE command like this: 






The __id dolumn is the pv-imavy key. 



CREATE TABLE DRINK (_id INTEGER PRIMARY KEY AUTOINCREMENT , 
NAME TEXT, 

The table name f ^ 

(/^DESCRIPTION TEXT, 

The table dolumns >^ IMAGE ^ RES0URCE ^ ID INTEGER) 



You can also use SQL to change an existing table using the ALTER 
TABLE command. As an example, here’s what the command looks like 
to add a column to a table: 

4^- The table name 

ALTER TABLE DRINK ^ 

ADD COLUMN FAVORITE NUMERIC ^ The dolumn you want to add 

In the example above, we’re adding a column called FAVORITE that 
holds numeric values to the DRINK table. 

On the next page, we’ll show you how to rename a table, or remove it 
from the database. 
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Renaming tables 

You can also use the ALTER TABLE command to rename a table. As 
an example, here’s how you’d rename the DRINK table to FOO: 

ALTER TABLE DRINK table 

RENAME TO FOO<^,The new name op -the -table 

delete tables by dropping them 

In addition to creating and altering tables, you can delete them using 
the DROP TABLE command: 

DROP TABLE DRINK Tbe name o£ *tbe "table you v/an-t *to remove 

This command is useful if you have a table in your database schema 
that you know you don’t need any more, and want to remove it in 
order to save space. 

Execute the SQL using execSQU) 

As you saw earlier in the chapter, you can execute SQL commands 
using the SQLiteDatabase execSQL () method: 

SQLiteDatabase . execSQL (String sql) ; 

As an example, here’s how you’d execute SQL to add a new 
FAVORITE column to the DRINK table: 

db . execSQL ( "ALTER TABLE DRINK ADD COLUMN FAVORITE NUMERIC ; " ) ; 

You can use the execSQL ( ) method any time you need to execute 
SQL on the database. 

Now that you’ve seen the sorts of actions you might want to 
perform when upgrading your database, let’s apply this to 
StarbuzzDatabaseHelperjava. 



466 Chapter 11 



SQLite databases 



The full SQLite helper code 



Here’s the full code for StarbuzzDatabaseHelperjava that will add a 
new FAVORITE column to the DRINK table. Update your code to 
match ours (the changes are in bold): 

package com. hfad . starbuzz ; 

import android . content . ContentValues ; 
import android. content . Context; 
import android. database . sqlite . SQLiteDatabase; 
import android. database . sqlite . SQLiteOpenHelper ; 



□ 

Starbuzz 

app/src/main 

4B 

java_ 

MU 

com . hfad . starbuzz 



class StarbuzzDatabaseHelper extends SQLiteOpenHelper { 



StarbuzzDatabase 

Helper.java 



private static final String DB_NAME = "starbuzz"; // the name of our database 

private static final int DB_VERSION =2; // the version of the database 

Chan<yn$ “the version number {. o a larger 
integer enables -the £$Lite helper to 
spot that you want to upgrade the 
database 



StarbuzzDatabaseHelper (Context context) { 

super (context, DB_NAME, null, DB_VERSION) ; 



QOverride 



public void onCreate (SQLiteDatabase db) { 



updateMyDatabase (db, 

} 



0 , 



DB_VERS I ON ) ; 



Well put -the £ode Lom the onCv-eateO 
method in the updateMyDatabaseO method- 



@Override 

public void onUpgrade (SQLiteDatabase 

updateMyDatabase (db , oldVersion , 






The todt bo upgrade the database is 
in our updateMyDatabaseO method- 



db, int oldVersion, 

newVersion) ; 



int newVersion) 



{ 



The lode Continues over the pa^e- 
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The SQUte helper code (continued) 



-►E71 



private void updateMyDatabase (SQLiteDatabase db, int oldVersion, int newVersion) { 
if (oldVersion < 1) { 

db.execSQL ("CREATE TABLE DRINK (_id INTEGER PRIMARY KEY AUTO INCREMENT , " 

+ "NAME TEXT , " 

+ "DESCRIPTION TEXT , " 

+ "IMAGE_RESOURCE_ID INTEGER);"); 

insertDrink (db, "Latte", "Espresso and steamed milk", R. drawable . latte) ; 
insertDrink (db, "Cappuccino", "Espresso, hot milk and steamed-milk foam", 

R . drawable . cappuccino) ; 

insertDrink (db, "Filter", "Our best drip coffee", R. drawable . filter) ; 

} 

if (oldVersion < 2) { 

db . execSQL ( "ALTER TABLE DRINK ADD COLUMN FAVORITE NUMERIC;"); 

> * 

\ Add 3 numevid FAVORITE 

dolurtm *to 'the DRIN^ "table- 



private static void insertDrink (SQLiteDatabase db. String name. 

String description, int resourceld) { 
ContentValues drinkValues = new ContentValues ( ) ; 
drinkValues . put ( "NAME" , name) ; 
drinkValues . put ( "DESCRIPTION" , description) ; 
drinkValues .put ( " IMAGE_RESOURCE_ID" , resourceld) ; 
db . insert ( "DRINK" , null, drinkValues); 

} 

} 



The new code in the SQLite helper means that existing users will 
get the new FAVORITE column added to the DRINK table the 
next time they access the database. It also means that any new 
users will get the complete database created for them, including 
the new column. 

We’ll go through what happens when the code runs on the next 
page. 
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What happens when the code runs 



O 



© 



When the database first needs to be accessed, the SQLite helper checks 
whether the database already exists. 




SQLite helper 



If the database doesn't exist, the SQLite helper creates it and runs its 
onCreate() method. 

Our onCreate ( ) method code calls the updateMyDatabase ( ) method. This creates the 
DRINK table (including the extra column) and populates the table with records. 




DRINK 



SQLite database 



onCreateQ 



SQLite helper 



Name: "starbuzz" 
Version: 2 



Q 



If the database already exists, the SQLite helper checks the version number 
of the database against the version number in the SQLite helper code. 

If the SQLite helper version number is higher than the database version, it calls the 
onUpgrade ( ) method. If the SQLite helper version number is lower than the database 
version, it calls the on Downgrade ( ) method. Our SQLite helper version number is 
higher than that of the database, so the onUpgrade ( ) method is called. It calls the 
updateMyDatabase ( ) method, and this adds an extra column called FAVORITE to the 
DRINK table. 



onUpgradeQ 




SQLite helper 



DRINK 




SQLite database 



Name: "starbuzz" 
Version^ 2 



you are here ► 



469 



CHAPTER 11 



toolbox 




Your Android Toolbox 



You’ve got Chapter 1 1 under 
your belt and now you’ve 
added creating, updating, 
upgrading databases to your 

toolbox. 



You tan download 
-the -full tode -for 
the tha^ter from 

httfs ; / / tinyurl-tom/ 

HeadT irstAndroid- 




BULLET POINTS 



■ Android uses SQLite as its backend 
database to persist data. 



The onCreate ( ) method gets called 
when the database first gets created. 



The SQLite Database class gives 
you access to the SQLite database. 



The onupgrade ( ) method gets called 
when the database needs to be upgraded. 



A SQLite helper lets you create and 
manage SQLite databases. You create 
a SQLite helper by extending the 

SQLiteOpenHelper class. 

You must implement the 

SQLiteOpenHelper onCreate ( ) 
and onupgrade ( ) methods. 

The database gets created the first time it 
needs to be accessed. You need to give 
the database a name and version number, 
starting at 1 . If you don’t give the database 
a name, it will just get created in memory. 



■ Execute SQL using the 

SQLiteDatabase 
execSQL (String) method. 

■ Add records to tables using the 
insert ( ) method. 

■ Update records using the update ( ) 
method. 

■ Remove records from tables using the 
delete ( ) method. 
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12 cursors and asynctasks 






Connecting to Databases + 
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So how do you connect your app to a SQLite database? 

So far you’ve seen how to create a SQLite database using a SQLite helper. The next step 
is to get your activities to access it. In this chapter, you’ll find out how to use cursors to 
get data from the database, how to navigate cursors, and how to get data from them 
You’ll then find out how to use cursor adapters to connect them to list views. Finally, 
you’ll see how writing efficient multithreaded code with AsyncTasks will keep your app 
speedy. 



this is a new chapter 471 



where we are 



The story so far... 



In Chapter 1 1, you saw how to write a SQLite helper to 
create a database, and how to add tables and prepopulate 
them with data. You also saw how to make the SQLite 
helper deal with database upgrades so that you can change 
the structure of the database and manipulate the data it 
contains by upgrading it. 

In this chapter, we’re going to show you how to get your 
activities to interact with the database so that your user can 
read from and write to the database using your app. 

Here’s the current state of our Starbuzz app: 



l/Ve've treated the SQLite helper 
and added tode so it tan create 
the Starbuzz database- It's not 
being used by any activities yet 




SQLite Helper 



ii - 

Starbuzz 

database 



The tVmk dass is s-fci|| bemj used- 



<Layout> 

</Layout> 




activity_top_level.xml 




Device TopLevelActivity.java 




We’re going to change the Starbuzz app so that it uses the 
Starbuzz SQLite database instead of the Java Drink class. 



PvmkA^'tivi'ty and 
PrinkCategoryActivity are 
still accessing prink-java- 



472 Chapter 12 




cursors and asynctasks 



Well change the app to use the database 



There are two activities that use the Drink class. We need to get them 
to read data from the SQLite database with assistance from the SQLite 
helper. Here’s what we’ll do: 



o 



Update the Drink code in Dr ink Activity. 

DrinkActivity uses the Drink class to display the details it has for a 
given drink. We’ll change the activity so that it retrieves the record for that 
drink from the Starbuzz database. 



o 



Update the Drink code in Dr inkCategory Activity. 

DrinkCategoryActivity uses the Drink class to display a list of 
all the drinks. We’ll change this so that the activity displays a list of all the 
records in the DRINK table. 



© 



Let users choose their favorite drinks. 

In Chapter 1 1 , we upgraded the database so that the DRINK table 
includes a FAVORITE column. We’ll change the app so that users can 
flag which drinks are their favorites, and display a list of these favorites in 
TopLevel Activity. 
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current DrinkActivity code 

The current PrinkActivity code 




DrinkActivity 

DrinkCategoryActivity 

Favorites 



Here’s a reminder of what the current DrinkActivity.java code looks 
like. The onCreate () method gets the drink number selected 
by the user, gets the drink details from the Drink class, and then 
populates the activity’s views using the drink attributes: 

package com. hfad. starbuzz; 

import android. app .Activity; 
import android. os . Bundle; 
import android . widget . ImageView; 
import android. widget . TextView; 




f A u 10:48 



DrinkActivity 
displays details o£ 
the drink the user 
selected- 

Cappuccino 

Espresso, hot milk, and a steamed milk foam 




public class DrinkActivity extends Activity { 



□ 

Starbuzz 



public static final String EXTRA_DRINKNO = "drinkNo"; 
@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_drink) ; 



app/src/main 

java_ 

Ma 



com . hfad .starbuzz 




//Get the drink from the intent 



This is the drink the user selected. DrinkActivity.java 



int drinkNo = ( Integer ) getlntent (). getExtras (). get (EXTRA_DRINKNO) ; 

Drink drink = Drink. drinks [drinkNo] ; ^ |/ S e the drink number -from the intent to jet the 

dv'mk from -the Prmk class. We'll weed to dhawje 

//Populate the drink image this so the driwk tomes from the database. 



ImageView photo = (ImageView) findViewByld (R. id. photo) ; 

photo . setlmageRe source (drink . getlmageResourceld ( ) ) ; 
photo . setContentDescription (drink . getName ( ) ) ; 




//Populate the drink name 
TextView name = (TextView) findViewByld (R. id. name) ; 

name . setText (drink . getName ( ) ) ; ^ 



We need to populate the 
views in the layout with 
values -from the database, 
not -Prom the Drink dass. 



//Populate the drink description 

TextView description = (TextView) findViewByld (R . id . description) ; 

description . setText (drink . getDescription ( ) ) ; ^ 
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fret data from the database with a cursor 

Our current DrinkActivity code depends on being able 
to get details of a particular drink from the Drink class. How 
do we change this so that we can retrieve drink details from the 
Starbuzz database instead? How do you change an activity so that it 
reads data from a database? 

The solution is to use a cursor. 

Cursors give you access to database data 

A cursor gives you access to database recordsets. You specify 
what data you want access to, and the cursor brings back the 
records from the database. You then navigate through the records 
supplied by the cursor. 




You create a cursor by specifying what data you want access to 
using a database query. So what’s a query? 
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query overview 

DrinkActivity 
DrinkCategoryActivity 
Favorites 

you want from the database 



A query lets you say what records 



A database query gives you a way of saying exactly which records you want access 
to from the database. As an example, you can say you want to access all the data 
from the DRINK table, or just those drinks whose name begins with “L”. The 
more you can restrict the data you return, the more efficient your query will be. 

Specify the table and columns 



The first thing to specify in your query is which table you want 
to get records from, and which columns you need. 



Return the data -from the MAMfc and 
DESCRIPTION Columns in -the DRIN* table. 



_id 


NAME 


DESCRIPTION 


IMAGE_RESOURCE_ID 


FAVORITE 


1 


“Latte” 


"Espresso and steamed milk" 


54543543 


0 


2 


“Cappuccino” 


"Espresso, hot milk and 
steamed-milk foam" 


654334453 


0 


3 


“Filter” 


"Our best drip coffee" 


44324234 


0 



declare any conditions that restrict your selection 

Once you’ve said what columns you want, you can filter your data by 
declaring any conditions the data must meet. In our app, for example, we 
want to retrieve the drink the user selected, and we can do this by only 
returning records where the drink _id has a particular value. 



Return ^ 
data /T 
v/here 
id is I. 



_id 


NAME 


DESCRIPTION 


IMAGE_RESOURCE_ID 


FAVORITE 


1 


“Latte” 


"Espresso and steamed milk" 


54543543 


0 


2 


“Cappuccino” 


"Espresso, hot milk and 
steamed-milk foam" 


654334453 


0 


3 


“Filter” 


"Our best drip coffee" 


44324234 


0 



Other stuff you can use queries for 

If you expect your query to return several rows of data, you might find 
it useful to say what order you want the records to be in. As an example, 
you might want to order the drink records in drink name order. You 
can also use queries to group the data in some way, and apply aggregate 
functions to it. As an example, you might want to return a count of how 
many drinks there are and display it in your app. 

So how do you create a query? 
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The SQLitePatabase query!) method 
lets you build SQL using a query builder 

You can build a query using the SQL iteDat abase 
query ( ) method. The query ( ) method returns an object 
of type Cursor, which your activities can use to access the 
database. 

Here is the basic form of the query ( ) method: 



public Cursor query (String table, < r table and dolwmns you want to adtess. 

String [ ] columns , 

The <\ueryO method stri selection, «^7 Use these it you want to apply Condi W 

returns a Cursor. J, 

String [] selectionArgs , 

String groupBy, 

String having, 4— — Mse -these i-p you { o -the data. 

String orderBy) ^ t>> . . 

Vo you want the data in a particular order? 



You can use this version of the query ( ) method to specify 
which table you want to return data from, which columns 
you want, what conditions you want to apply to the data, 
what data aggregations you need, and how you want the data 
ordered. 

There are several other overloaded versions of the query ( ) 
method which allow you to add extra details to your query, 
such as whether you want each row to be unique, and 
the maximum number of rows you want to be returned. 

We’re not going to go into all these variations, but if you’re 
interested, you can find a full list of the overloaded methods 
in the online Android documentation: 

http:/ / developer, android, com/ reference/ android/ database/ 
sqlite/SQLiteDatabase. html 

Over the next few pages, we’ll go through some of the most 
common ways in which you might want to use the query ( ) 
method. 



Behind the scenes, 
Android uses the 
cjueryO method to 
construct an SQL 
SELECT statement. 
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Specifying table and columns 

The simplest type of database query you can create is to return all 
the records for particular columns without specifying criteria. To do 
this, put the name of the table as the first parameter, and a String 
array of the column names as the second. As an example, here’s 
how you’d use the query ( ) method to return the contents of the 
name and description columns from the DRINK table: 



Cursor cursor = db . query ( "DRINK" , 

new String [] 

This <\uevy only uses -the -first two 
parameters, hende -the hull values. 



{ "NAME" 



Put eadh dolumn you want badk as a 
separate value in a String array- 

"DESCRIPTION" } , 



null, null, null, null, null) ; 



The <\i*evy v-eiwns all the data -from 
the NAME and DESCRIPTION 
Columns in the DRINIn table- 



NAME 


DESCRIPTION 


“Latte” 


"Espresso and steamed milk" 


“Cappuccino” 


"Espresso, hot milk and 




steamed-milk foam" 


“Filter” 


"Our best drip coffee" 



Restrict your query by applying conditions 

You can apply conditions to your database query by specifying what 
values particular columns should have using the third and fourth 
query parameters. As an example, here’s how you’d say you only 
want to return records from the DRINK table where the name of 
the drink is “Latte”: 



Cursor cursor = db . query ( "DRINK" , 

new String [] {"NAME", "DESCRIPTION"}, 

"NAME = ?" , <: This means "where the Contents 

new String [] {"Latte"}, 4 ^ o-P ‘the NAM£ dolumn is 'Latte” • 

null, null, null) ; 



The third parameter "NAME = ? " means that the NAME column 
should equal some value. The ? symbol is a placeholder symbol for 
this value. The query uses the contents of the fourth parameter to 
say what the value should be (in this case, “Latte”). 

The cpAevy returns all the data -from the NAME- 

and DESCRIPTION dolumns in the DRIN^ table ~ 
where the value o-f the NAME- dolumn is Latte • 



NAME 


DESCRIPTION 


“Latte” 


"Espresso and steamed milk" 
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Applying multiple conditions to your query 

If you want to apply multiple conditions to your query, you 
need to make sure you specify the conditions in the same order 
you specify the values. As an example, here’s how you’d return 
records from the DRINK table where the name of the drink is 
“Latte”, or the drink description is “Our best drip coffee”. 



Cursor cursor = db . query ( "DRINK", 

This means where NAM£ is 

new String [ ] { "NAME" , "DESCRIPTION" } , ^ DESCRIPTION is 

"NAME = ? OR DESCRIPTION = ?", <T ^“'Out best drip Coffee'". 

new String [] {"Latte", "Our best drip coffee"}, 

null, null, null) ; 



The <\uev-y returns all the data ^vom the NAME- and 
DESCRIPTION Columns in Ihe DRIN^ -table where -the 

value of -the NAME Column is "Latte" or the value ot 
the DESCRIPTION column is “Our best dv-iy Coffee". 



NAME 


DESCRIPTION 


“Latte” 


"Espresso and steamed milk" 


“Filter” 


"Our Lest drip coffee" 



If you specify the conditions in a different order to the values, 
your cursor will return the wrong data. As an example, it might 
pair the value “Latte” with the DESCRIPTION column rather 
than the NAME column. This wouldn’t return any records. 

You specify conditions as String values 

The condition values must be Strings. If the column you’re 
applying the condition to doesn’t contain text, you still need to 
convert your values to Strings. As an example, here’s how 
you’d return DRINK records where the _id is 1 : 

Cursor cursor = db . query ( "Drink" , 

new String [] {"NAME", "DESCRIPTION"}, 

" id = ?", 

- — • Convert “the int I 

new String [] {Integer. toString(l) }, ^ a Strmj value. 

null, null, null) ; 

The <^uery v-e*tu\nr\s all the data *fvom -the NAME 
and DESCRIPTION columns in Ihe DRIN* -table — > 

where -the value of -the _\A Column is I . 



_id 


NAME 


DESCRIPTION 


1 


“Latte” 


"Espresso and steamed milk" 
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If you want to display data in your app in a particular order, you 
can use the query to sort the data by a particular column. This 
can be useful if, for example, you want to display drink names in 
alphabetical order. 

By default, the data in the table appears in _id order as this was 
the order in which data was entered: 



Order data in your query 



_id 


NAME 


DESCRIPTION 


IMAGE_RESOURCE_ID 


FAVORITE 


1 


“Latte” 


"Espresso and steamed milk" 


54543543 


i 


2 


“Cappuccino” 


"Espresso, hot milk and 
steamed-milk foam" 


654334453 


0 


3 


“Filter” 


"Our best drip coffee" 


44324234 


0 



If you wanted to retrieve data from the NAME and FAVORITE 
column in ascending NAME order, you could use the following: 



Cursor cursor = db . query ( "DRINK", 

new String [] { "_id", "NAME", "FAVORITE"}, 

null, null, null, null, 

"NAME ASC'Of^/v , , 

Order by NAME in ascending order. 



NAME 


FAVORITE 


“Cappuccino” 


0 


“Filter” 


0 


“Latte” 


1 



The ASG keyword means that you want to order that column 
in ascending order. Columns are ordered in ascending order by 
default, so if you want you can omit the ASC. To order the data 
in descending order instead, you’d use DESC. 




You can sort by multiple columns too. As an example, here’s how 
you’d order by FAVORITE in descending order, followed by 
NAME in ascending order: 



Cursor cursor = db . query ( "DRINK" , 

new String [] {"_id M , "NAME", "FAVORITE"}, 

null, null, null, null, 

"FAVORITE DESC, NAME" ) Order by FAVORlTB in 

des^e^ding order, -then 

NAME in ascending order. 

You’ve now seen the most common ways of using the query ( ) 
method, but there are still more things you can do. 
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Using SQL functions in queries 

If you’re familiar with SQL functions, the great news is you 
can use them in queries. They allow you to retrieve things like 
the number of rows in a table, the average value of a column, 
or the highest value. 

Here are some of the most useful SQL functions you can use in 
your queries: 



AVG() 


The average value 


COUNTO 


The number of rows 


SUMO 


The sum 


MAX() 


The largest value 


MIN() 


The smallest value 



As an example, if you wanted to count how many drinks there 
are in the DRINK table, you could use the SQL COUNT ( ) 
function to count the number of values in the _id column: 

Cursor cursor = db . query ( "DRINK", 

new String [] { "COUNT (_id) 



This vetuvns -the numbev o( drinks in a 
Column labeled W dowvt W 

AS count" } , 



null, null, null, null, null) ; 



The <\uevy vetuvns -the r\ur*bev 
of vows in “the DRIN^ table- ^ 



count 

3 



If the DRINK table contained an extra PRICE column that 
gave the price of each drink, you could find out the average 
drink price using the SQL AVG ( ) function to find the average 
value of the PRICE column: 



Cursor cursor 



db . query ( "DRINK" , 

new String [] {"AVG (PRICE) AS price"}, 

null, null, null, null, null) ; 

Ouv DRIN^ -table doesn't donta'm a 

^ PRICE doluwm, bu*t i*f it did, we dould 

use it *to $et the aveva^e dvink pviee- 



price 

4.17 
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SQL GROUP PY and HAVING- clauses 

If you’re familiar with the GROUP BY and HAVING clauses 
of SQL, you can use these in the fifth and sixth parameters of 
the query ( ) method. 

As an example, suppose you wanted to find out how many 
drinks there are for each value of FAVORITE. To do this, 
you’d create a query to return the FAVORITE column and a 
count of drinks. You’d then group by the FAVORITE column 
to return the number of drinks there are for each value of 
FAVORITE: 




We’re not teaching 
you SQL in this 
book, just giving 
you a glimpse of 
what you can do. 



If you think this is something you’ll 
find useful, we suggest picking up a 
copy of Head First SQL. 



Cursor cursor = db . query ( "DRINK", 

new String [ ] 
null, null, 

6tro U ? by the FAVORITE ^ "favorite" , 

null, null) ; 



"FAVORITE", "COUNT (_id) AS count" 

Return the FfyVORlTB Column 

3nd the number ot drinks. 



If the data in the DRINKS table looks like this: 



_id 


NAME 


DESCRIPTION 


IMAGE_RESOURCE_ID 


FAVORITE 


1 


“Latte” 


"Espresso and steamed milk" 


54543543 


i 


2 


“Cappuccino” 


"Espresso, hot milk and 
steamed-milk foam" 


654334453 


0 


3 


“Filter” 


"Our hest drip coffee" 


44324234 


0 



the query will return data like this: 



FAVORITE 


count 


i 


i 


0 


2 



/ 



There^s I drink where FAVORITE has a value o-f l } 
- and 2- drinks where BA\/0KITB has a value of O . 



Now that you’ve seen how to create a cursor using the 
query ( ) method, it’s time for you to have a go at creating one 
for the Starbuzz app. 
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Code Magnets 

In our code for DrinkActivity, we want to get the name, 
description, and image resource ID for the drink passed to it in an 
intent. Can you construct a query ( ) method that will do that? 



int drinkNo = ( Integer ) getlntent (). getExtras (). get (EXTRA_DRINKNO) ; 

Cursor cursor = db. query ( , 

new String [] { , , }, 



new String [] { }, 

null, null, null); 



Integer 





toString 




"IMAGE RESOURCE ID" 



"DESCRIPTION" 





"DRINK" 
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4 




Code Magnets Solution 

In our code for DrinkActivity we want to get the name, 
description and image resource ID for the drink passed to it in an 
intent. Can you construct a query ( ) method that will do that? 




int drinkNo = ( Integer ) getlntent (). getExtras (). get (EXTRA_DRINKNO) ; 

- We wan-t -to addess -the PRINK table- 

Cursor cursor - db . query ([JTOmcJ, ^ pKCRIPTION, a«l (*IME_RESCMRC6JD C.W 

new String [ ] { 




new String [] { Integer 



null, null, null); 



dv-ink/Vo is an irrt, so needed h> 
be £on vev-ted b> a S-fo-ing. 



fret a reference to the database 

Over the past few pages, you’ve seen how to build a query that returns 
a cursor. The query ( ) method is defined in the SQLiteDatabase 
class, which means in order to call it we need to get a reference to our 
Starbuzz database. The SQLiteOpenHelper class implements a couple 
of methods that can help us with this: getReadableDatabase ( ) and 
getWritableDatabase () . Each of these methods returns an object of 
type SQLiteDatabase, which gives us access to the database. You call the 
methods like this: 

SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper (this) ; 

SQLiteDatabase db = starbuzzDatabaseHelper . getReadableDatabase () ; 



A cursor lets you 
read data from 
the database. 



SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper (this ) ; 

SQLiteDatabase db = starbuzzDatabaseHelper . getWritableDatabase () ; 

So what’s the difference between these two methods? 
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getReadablePatabaseQ versus 
getWritablePatabaseO 

You’re probably thinking that getReadableDatabase ( ) returns a 
read-only database object, and getWritableDatabase ( ) returns one 
that’s writable. In fact, most of the time getReadableDatabase ( ) and 
getWritableDatabase ( ) both return a reference to the same 
database object. This database object can be used to read and write data 
to the database. So why is there a getReadableDatabase ( ) method if 
it returns the same object as the getWriteableDat abase ( ) method? 

The key difference between the getReadableDatabase ( ) and 
getWritableDatabase ( ) methods is what happens if it’s not possible 
to write to the database. This can happen if the disk is full, for instance. 

If you use the getWritableDatabase ( ) method in this case, the 
method will fail, and throw a SQLiteException. But if you use the 
getReadableDatabase ( ) method, the method will try to get a read- 
only reference to the database. It may still throw a SQLiteException if it 
can’t get read-only access to the database. 

If you only need read data from a database, you’re best off using the Viu II probably be able to write to the 

getReadableDatabase ( ) method. If you need to write to the database,^ database i-f you use getReadableDatabaseO, 
use the getWritableDatabase () method instead. but it*s not guaranteed- 



getReadablePatabaseO getWritablePatabaseO 





Writable 

Database 




Readable 

Database 



SQLiteException 

gelReadablePalabaseO Vies V gel read/ wile 
attess to tbe database -f irst- l-f it -fails, it then tries 
to get read-only attess to tbe database- l-f it still 
ean'-t gel attess, il lbro*« a S#Lile£*tepliov>. 



Get read/write 
.access to database. 



Success 



Fail 

/L 




Writable 

Database 



getWritableDatabaseO tries to 
get read/ write aeeess to tbe 
database- l-f it -fails, it throws 
a £$Lite£*eeption. 



SQLiteException 
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The code for getting a cursor 
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Putting all of this together, here’s the code for getting a cursor. We’ll 
use this code later in the onCreate ( ) method of our activity. 



We <W-t need bo wv-i-te bo 
“the database so weVe usinq 

try { getReadableDatabaseO. 

SQLiteOpenHelper starbuzzDatabaseHelper = new Starbuz zDatabaseHelper ( this ) ; ) 

SQLiteDatabase db = starbuzzDatabaseHelper . getReadableDatabase (); ^> 

Cursor cursor = db . query ( "DRINK", 

new String [] {"NAME", "DESCRIPTION", " IMAGE_RESOURCE_ID" } , 

- d ’ ' The duvsov 

new String [] { Integer . toString (drinkNo) } don*tains a single 

null, null, null) ; v-e£ovd 3s *the __id 

dolumn don*lains 
unique vedovds. 



/ /« - - . , , , . . , , . , l/Vie h3vc "the du\rso\r, 

//Code to do something with the cursor . . ’ 

but we still need to 



do something with it- 
ase unavailable", 

- Display a message i*P the database is unavailable- 



} catch (SQLiteException e) { 

Toast toast = Toast .makeText (this, "Database unavailable", Toast . LENGTH_SHORT) ; 
toast . show () ; 

^ V-TV.c 



What the code does 

Q The starbuzzDatabaseHelper is created. 



I 



starbuzzDatabaseHelper 

starbuzzDatabaseHelper creates a SQLiteDatabase object called db. 



f 



starbuzzDatabaseHelper db 

@ The cursor is created by calling the SQLiteDatabase query() method. 



f 



query(...) 



starbuzzDatabaseHelper db 
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To read a record from a cursor, 
you first need to navigate to it 

You’ve now seen how to create a cursor; you use the 
SQLiteDatabase query ( ) method to say what data you 
want the cursor to return. But that’s not the end of the story — 
we need to read values from it. 

Whenever you need to retrieve values from a particular record 
in a cursor, you first need to navigate to that record. You need 
to do this irrespective of how many records are returned by 
the cursor. 




On the next page, we’ll look at how you navigate cursors. 
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Navigating cursors 

There are four main methods you use to navigate through the records 
in a cursor. These methods are moveToFirst ( ) , moveToLast ( ) , 
moveToPrevious ( ) , and moveToNext ( ) . 

To get access to the first record returned by the cursor, you can use its 
moveToFirst ( ) method (it returns a value of true if it finds a 
record, and false if the cursor hasn’t returned any records): 

if (cursor .moveToFirst () ) { 

//Do something 

} ; 



If you want to navigate to the last record returned by the cursor, 
you can use the moveToLast ( ) method instead (just like the 
moveToFirst () method, it returns a value of true if it finds a 
record, and false if it doesn’t): 

if (cursor .moveToLast () ) { 

//Do something 

} ; 



To iterate through the records in the cursor, you use the 
moveToPrevious ( ) and moveToNext ( ) methods. 



DrinkActivity 

DrinkCategoryActivity 

Favorites 



Move to the £ irst row. 

i 




A: 

Move -to -the last V"OV/. 




The moveToPrevious ( ) method moves you to the previous record 
in the cursor (it returns true if it succeeds in moving to the previous 
record, and false if it fails — which could be because it’s already at the 
first record, or because the cursor doesn’t contain any records): 

if (cursor .moveToPrevious () ) { 

//Do something 

} ; 



The moveToNext ( ) method works in the same way as the 
moveToPrevious ( ) method, except that it moves you to the next 
record in the cursor (it returns true if it succeeds in moving to the next 
record, and false if it fails): 

if (cursor .moveToNext () ) { 

//Do something 

} ; 

Once you’ve navigated to a record in your cursor, you can access its 
values. We’ll look at that on the next page. 




T 

Move -to -the v-ov/. 
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fretting cursor values 



Once you’ve moved to a record in a cursor, you can retrieve values 
from it so that you can display them in your activity’s views. You 
retrieve a value from the current record in a cursor using its get* ( ) 
methods. The exact method you use for this depends on the type 
of value you want to retrieve. As an example, the getStringO 
method returns the value of a column as a String, and the 
getlnt ( ) method returns the value of a column as an in t. Each of 
the methods takes a single parameter, the column index. 

As an example, here’s the query we used to create our cursor: 



Cursor cursor = db. query ("Drink", 

new String [] {"NAME", "DESCRIPTION", " IMAGE_RESOURCE_ID" } , 
"_id = ?", 

new String [ ] { Integer . toString ( 1 )} , 

null, null, null); 



The cursor has three columns: NAME, DESCRIPTION, and 
IMAGE_RES OURC E_ID. The first two columns, NAME and 
DESCRIPTION, contain data of type String. The third column, 
IMAGE_RESOURCE_ID, contains data of type int. 

Suppose you wanted to get the value of the NAME column for the 
current record. NAME is the first column in the cursor, and contains 
String values. You’d therefore get the contents of the NAME 
column using the getStringO method like this: 



Column 0 

V 


Column 1 


Column Z 

'A 






IMAGE. 


NAME 


DESCRIPTION 


RESOURCE. 






ID 


“Latte” 


"Espresso and 
steamed milk" 


54543543 



String name = cursor . gets tring(O); 



-This is *thc -fivst Column in *thc duirsov. 



Similarly, suppose you wanted to get the contents of the 
IMAGE_RESOURCE_ID column. This is the third column in the 
cursor, and contains int values, so you’d use the code: 

int imageResource = cursor . getlnt (2) ; 

Finally, close the cursor and database 

Once you’ve finished retrieving values from the cursor, you need to 
close the cursor and the database in order to release their resources. 
You do this by calling the cursor and database close ( ) methods: 

cursor . close ( ) ; 
db. close () ; 



ta * tmd de-tails o( all the Cursor get 
methods m http/ / developeir.android.dom/ 
ve+eirenee/ android/ database/Cursorhtml. 



We’ve now covered all the code we need to replace the code in 
DrinkActivity so that it gets its data from the Starbuzz database. 
Let’s look at the code. 
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The PrinkActivity code 



Here’s the full code for DrinkActivity.java (apply the changes in bold to 
your code, then save your work): 



v 



DrinkActivity 

DrinkCategoryActivity 

Favorites 



package com. hfad. starbuzz ; 

import android. app .Activity; 
import android . os . Bundle ; 
import android . widget . ImageView; 
import android . widget . TextView; 

import android . widget . Toast ; 
import android . database . Cursor ; 
import android . database . sqlite . SQLiteDatabase ; 
import android . database . sqlite . SQLiteException ; 
import android . database . sqlite . SQLiteOpenHelper ; 



WeVe us'm^ -these extra 

classes in the dode- 




□ 

Starbuzz 

app/src/main 

java 

LQ 

com. hfad. starbuzz 

L @ 

DrinkActivity.java 



public class DrinkActivity extends Activity { 



public static final String EXTRA_DRINKNO = "drinkNo"; 



@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_drink) ; 



This is the ID ot the 
drink the user dhose. 



//Get the drink from the intent 






int drinkNo = ( Integer ) getlntent (). getExtras (). get (EXTRA_DRINKNO) ; 



//Create a cursor 
try { 

SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper (this) ; 
SQLiteDatabase db = starbuzzDatabaseHelper . getReadableDatabase () ; 

Cursor cursor = db. query ("DRINK" , 

new String [] { "NAME" , "DESCRIPTION", "IMAGE_RESOURCE_ID" } , 

"_id = ?", 

new String [ ] { Integer . toString (drinkNo) } , The do(Je 

null, null, null); on the next faje- 



t 

Create a dursor that $ets the 

MAMZ, DESCRIPTION, and 
RESOWRCEJD data -from the DRIN^ 

table where __ id matdhes drinkNo. 



490 Chapter 12 



cursors and asynctasks 



The PrinkActivity code (continued) 



□ 

IUZZ 

41 ] 



Starbuzz 



/cl 

LO 



[(l) ; 



com. hfad. starbuzz 

l_£ 



int photold = cursor . getlnt (2) ; 



D r i n k Ac ti v i ty.j a va 




//Populate the drink name 

TextView name = (TextView) f indViewByld (R . id . name ) 

name . setText (nameText) ; 



Use the d3“td •P^o** "tV^c dursor 
to populate the views 



//Move to the first record in the Cursor 

app/sre/main 

if (cursor. moveToFirst () ) { ^“There's only one record in the Cursor, I— f 1 

but we still need to move to it- java 

The name o*p -the //Get the drink details from the cursor 
drink is -the -Pirs-t String nameText = cursor . gets tring (0) ; 
item in the £ursor^. String descriptionText = cursor . getString 

is the second 
Column, and the 
image resource 
IP is the third- 
That s because we 
told the Cursor 
to use the NAME, 

description, 

IMA6 j£_ 

RESOURCEJD 

Columns -from the 
database i n that 

order. //Populate the drink image 

ImageView photo = (ImageView) findViewByld (R. id. photo) ; 

photo . setlmageRe source (photold) ; ^ 

photo . setContentDescription (nameText) ; 

} 

cursor . close ( ) ; 

db. close () ; - — ' Close the Cursor and database. 

} catch (SQLiteException e) { 

Toast toast = Toast .makeText (this , "Database unavailable". Toast. LENGTH SHORT) 



//Populate the drink description 
TextView description = (TextView) findViewByld (R . id . description) ; 

description . setText (descriptionText) ; 




toast. show () ; 






l-f a SQLiteE*teption is thrown, this means there's a problem with the 
database- In this ease, we'll use a Toast to display a message to the user. 



So that’s the DrinkActivity code complete. Let’s see 
what’s next. 



]( "Relax 



Connecting your 
activities to a database 
takes more code than 
using a Java class. 



But if you take your time working through 
the code in this chapter, you’ll be fine. 



you are here ► 



491 



where we are 



What we've done so far 

Now that we’ve finished updating the DrinkActivity.java code, let’s 
look at the app structure diagram to see what we’ve done, and 
what we need to do next. 



v 



DrinkActivity 

DrinkCategoryActivity 

Favorites 



<Layou-t> 



</Layou-fc> I 






Device 



activi+y_top_level.xml 

N 

O' 

TopLevelAc+ivi+y.java 



D\rihkCatcgo\ryA^-tivi-ty 
still gets its dv'mk 
data -fv-orw the tVmk 
class. ^ 




Drink.java 






o 



DrinkCategoryActivity.java 



DrinkActivity now gets all of its drink data from the 
Starbuzz database. Next, we need to update the code in 
DrinkCategoryActivity so that it uses data from 
the database rather than from the Java Drink class. 




activity_drink.xml 
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Starbuzz 

database 



SQLite Helper 



DrinkActivity.java 

T 

PvmkA^tWi'ty has 
been changed so 
it gets its data 
-fy-or* the Stavbuzz. 
database via the 
SQLite helpev. 



tW©i£tr© n© 

Dumb Questions 




How much SQL do I need to know to create cursors? 



It’s useful to have an understanding of SQL SELECT 
statements, as behind the scenes the query ( ) method 
translates to one. In general, your queries probably won’t be too 
complex, but SQL knowledge is a useful skill. 



o? You said that if the database can’t be accessed, a 
SQLiteException is thrown. How should I deal with it? 



First, check the exception details. The exception might be 
caused by an error in SQL syntax which you can then rectify. 



How you handle the exception depends on the impact it has 
on your app. As an example, if you can get read access to the 
database but can’t write to it, you can still give the user read-only 
access to the database, but you might want to tell the user that you 
can’t save their changes. Ultimately, it all depends on your app. 
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The current PrinkCategory Activity code 

Here’s a reminder of what the current DrinkCategoryActivity.java code looks 
like. The onCreate () method populates a ListView with drinks using 
an ArrayAdapter. The onListltemClick ( ) method adds the drink 
the user selects to an intent, and then starts DrinkActivity: 



package com. hfad. starbuzz ; 



v 



Latte 



cursors and asynctasks 

DrinkActivity 

DrinkCategoryActivity 

Favorites 



M Q 10:26 



Pv-mkCaiegov-yAaivi-ty 

Cappuccino displays a list ol drmks. 



Filter 



import android . app . ListActivity ; 
import android . os . Bundle; 
import android . widget . ArrayAdapter ; 
import android . widget . ListView; 
import android . view .View; 
import android . content . Intent ; 



□ 

Starbuzz 

43 

app/src/main 

H3 



java 



public class DrinkCategoryActivity extends ListActivity { 
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com . hfad .starbuzz 

l_E 



@Override 

protected void onCreate (Bundle savedlnstanceState ) { 

super . onCreate (savedlnstanceState) ; 

ListView listDrinks = getListView ( ) ; 

ArrayAdapter<Drink> listAdapter = new ArrayAdapter<Drink> ( 
this , 

android . R . layout . simple_lis t_i tem_l , 

Drink . drinks) ; 

listDrinks . setAdapter (listAdapter) ; 



DrinkCategory 

Activity.java 



} 



A*l the moment, weVe us'm^ 
an Av-v-ayAdaptev- to bind an 
av-vay to the ListView. We 
need to veplade this dode so 
that the data domes *fvom a 
database instead- 



@Override 

public void onListltemClick (ListView listView, 

View itemView, 
int position, 
long id) { 

Intent intent = new Intent (DrinkCategoryActivity . this , DrinkActivity . class ) ; 
intent . putExtra ( DrinkActivity . EXTRA_DRINKNO, (int) id) ; 
startActivity (intent) ; 

} 



you are here ► 
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cursor adapters 



How do we replace the array data 
in the listView? 




DrinkActivity 

DrinkCategoryActivity 

Favorites 



The listDrinks list view gets its data from the Drink . drinks 
array. Now, what we could do is read the list of drinks from the 
database, and then store them in an array that we pass to the array 
adapter. 



That would work, but can you think of a reason why that might be a 



bad idea? 

Wt tould just read the data A-or* the 
database and store it i n a* array. 



The* v/e dould keep array adapter 
and the rest ©-£ the £ode would be 
the sarwe- But is this a $ood idea? 

it 




Array 

b 



Array 
_ Adapter 






ListView 

0 



For our very small database, there’s no real problem in reading all of 
the data from the database and storing it in an array in memory. But if 
you have an app that stores a very large amount of data, then it’s going 
to take some time to read it all out of the database. It may also take a 
lot of memory to store it all in an array some place. 

Instead, we’re going to switch from using an ArrayAdapter to a 

CursorAdapter. 



Database 




Cursor 




Cursor 




data 








_ Adapter 





>^> 



ListView 



0 



A CursorAdapter is just like an ArrayAdapter, except instead 
of getting its data from an array, it reads the data from a cursor. 

Let’s look at how it works. 



Ouv data is in the tov-m ot a tuv-sov, 
so we da* use a Ci*v-sorAdaftev- to 
ylwj it into the ListView- 
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A Cursor Adapter reads just enough data 

Let’s pretend that our database is a lot larger. For example, let’s say 
Starbuzz massively extended its range of artisan coffees for the hipster 
market. Instead of three types of coffee, the different combinations of 
extra shots, milk, and granola sprinkles might mean that we need to store 
300 drinks in the database. But we can only see a few at a time in the list. 

The ListView can only display a limited number of items at one time. 
On a small device, it might only initially show, say, the first 1 1 coffees. If 
we were using an array, we would have to read all 300 coffees from the 
database into the array before we could display any on the screen. 

That’s not how it works with a Curs or Adapter. 



© 



The ListView gets displayed on the screen. 

When the list is first displayed, it will be sized to fit the screen. Let’s say it 
has space to show five items. 



These are the items 
the Listl/iew has 
spade to display. Wert 
using -five to keep 
things simple, but in 
pradtide it s likely to 
be moire- 




o 



The ListView asks its adapter for the first five items. 

The ListView doesn’t know where the data is coming from — whether it’s 
an array or a database — but it does know that it will be given the data by its 
adapter. So it makes a request to the adapter for the first five drinks. 




ListView Cursor Adapter 



you are here ► 
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what happens 



The story continues 




Drill kActivity 

DrinkCategoryActivity 

Favorites 



O 



The Cursor Adapter asks its cursor to read five rows from the database. 

A Cursor Adapter is given a cursor when it’s constructed, and it will ask the cursor for 
data only when it needs it. 





The cursor reads the first five rows from the database. 

Even though the database table contains 300 rows, the cursor only needs to read the first five. 
That’s a lot more efficient, and it means that the screen can start displaying data much sooner. 



o 







Database 



The user scrolls the list. 

As the user scrolls the list, the Curs or Adapter asks the cursor to read a few more 
rows from the database. If the user scrolls the list just a little, and uncovers one new 
item, the cursor will read one more row from the database. 




So a Curs or Adapter is a lot more efficient than the ArrayAdapter. It 
only reads the data it needs. That means it’s faster and takes up less memory, 
and speed and memory are both important things to keep in mind. 
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A SimpleCorsorAdapter waps data to views 



We’re going to create a simple cursor adapter to use 
with our app. A Simple Curs or Adapter is an 
implementation of Curs or Adapter that can be used in 
most cases where you need to display cursor data in a list 
view It takes columns from a cursor, and maps them to 
TextViews or ImageViews. 

In our case, we want to display a list of drink names in 
our DrinkCategoryActivity list view, so we’ll use a 
simple cursor adapter to map the name of each drink to a 
text view in the list view: 



Ouv ListView displays 
ea£h dv-ink name in a 
separate TextView. 



android.widget.Adapter 







CursorAdapter 



android.widget. 

ArrayAdapter 




android.widget. 

CursorAdapter 












android.widget. 

SimpleCursorAdapter 



* 

Arv-ayAdapter and 
Cursor Adapter are 
both types o£ Adapter. 
SimpleCursorAdapter 
is a subclass o( 

Cursor Adapter. 



First, create the cursor 

The first thing to think about when creating a cursor to use with a cursor 
adapter is what columns the cursor needs to contain. The cursor should 
include all the columns that need to be displayed in the list view, along 
with a column called _id. The _id column must be included, or the cursor 
adapter won’t work. So why’s that? 

In Chapter 1 1, we mentioned that it was an Android convention to give 
the primary key column in a table the name _id. This is so integral to 
Android that the cursor adapter assumes that this column will be there , and uses it 
to uniquely identify each row in the cursor. When you use a cursor adapter 
with a list view, the list view uses this column to identify which row the user 
has clicked. 



As we’re using a cursor adapter to display the names of the drinks, our 
cursor must contain the _id and NAME columns like this: 



cursor = db . query ("DRINK" , new String [] { M _id M , 
null, null, null, null, null) ; 



"NAME"}, 






IA/c mus-t indude the __id 
Column, even -though v/eVe 
not displaying its data. 



On the next page, we’ll use the cursor to create the cursor adapter. 
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SimpleCursorAdapter 



DrinkActivity 

DrinkCategoryActivity 

Favorites 



To create a simple cursor adapter, you need to tell it how you want the data 
to be displayed, which cursor to use, and which columns should be mapped 
to which views. Here’s how you’d create a simple cursor adapter to display a 
list of drink names: 

cursor = db . query ( "DRINK" , new String []{ "_id" , "NAME"}, 
null, null, null, null, null) ; 

Curs or Adapter listAdapter = new SimpleCursorAdapter (this , 

android. R. layout. simple_list_item_l,<^ This is the same layout we used with 
This is the dursor. — ^ cursor , the array adapter. It displays a single 

new String [] {"NAME"} , ^ v ^ uC ^ oV " ro}N m the list view- 

new int [] {android. R. id. textl } , pisplay the dontents of the NAME- 
0) ; dolumn in the List\/iew text views. 

listDrinks . setAdapter ( listAdapter ) ; <^Use setAdapterO to donnedt the adapter to the list view. 



This is the dursor -from the previous page. 

\L 



\/ 



Creating the SimpleCursorAdapter 



Just as we did with the array adapter, we’re using android . R . layout . 
simple_list_item_l to tell Android that we want to display each row 
in the cursor as a single text view in the list view. This text view has an ID of 
android . R . id . textl. 

The general form of the SimpleCursorAdapter constructor looks like 
this: 



How -to display -the data- You 
tan ms e the same layout you 
used with an avv-ay adapter. 



SimpleCursorAdapter adapter = new SimpleCursorAdapter (Context context, 



int layout, ^ s 

The dursor you dreate ^Cursor cursor. 

The dursor should indlude 

"the id dolumn, and "the 

data you want to appear. 



String [] fromColumns, 



int 



The context and layout parameters are exactly the same ones you used 
when you created an array adapter, context is the current context, and 
layout says how you want to display the data. Instead of saying which array 
we need to get our data from, we need to specify which cursor contains the 
data using the cursor parameter. You then use fromColumns to specify 
which columns in the cursor you want to use, and to Views to say which 
views you want to display them in. 



] toViews, 


^ — l/Vhidh dolumns 


flags) 


in the dursor to 


T 


matdh to whidh 


Used to 


views 


determine 




the behavior 




o£ the dursor. 





The flags parameter is generally set to 0, which is the default. The 
alternative is to set it to FLAG_REGISTER_CONTENT_OBSERVER to 
register a content observer that will be notified when the content changes. 
We’re not covering this here, as it can lead to memory leaks. Later in the 
chapter, you’ll see how to deal with the underlying data changing. 
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Closing the cursor and database 



When we introduced you to cursors earlier in the chapter, we 
said that you needed to close the cursor and database after 
you’d finished with it in order to release their resources. In our 
DrinkActivity code, we used a cursor to retrieve drink details 
from the database, and once we’d used these values with our views, 
we immediately closed the cursor and database. 



When you use a cursor adapter, it works slightly differently; the 
cursor adapter needs the cursor to stay open in case it needs to 
retrieve more data from it. This will happen if the user scrolls 
down the list of items in the list view, and needs to see more data. 




This means that you can’t immediately close the cursor and 
database once you’ve used the set Adapter ( ) method to 
connect it to your list view. Instead, you can use the activity’s 
onDestroyO method to close them. As the activity’s being 
destroyed, there’s no further need for the cursor or database 
connection, so they can be closed: 



c f 

I* you dose -the dursor 
too soon, the £u\rsov 
adapter won^t be able 
to get more data -Pr om 
the Cursor. 



public void onDestroyO { 
super . onDes troy () ; 
cursor . close ( ) ; 

db. close () ; ^ ^»f!lose the dursor and database 
i when the activity is destroyed- 



On the next page, see if you can update the code for 
DrinkCategoryActivity. 



you are here ► 
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exercise 




P aal puzz]6 



Your job is to take code segments from the 
pool and place them into the blank lines 
in DrinkCategory Activity. java. You may 
not use the same code segment more 
than once, and you won't need to use 
all the code segments. Your goal is 
to populate the ListView with a list of 
drinks from the database. 



public class DrinkCategoryActivity extends ListActivity { 

private SQLiteDatabase db; 
private Cursor cursor; 

@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 

ListView listDrinks = getListView ( ) ; 



□ 

Starbuzz 

4D 

app/src/main 

java_ 

MU 



com. hfad. starbuzz 




DrinkCategory 

Activity.java 



try { 



starbuzzDatabaseHelper 
db = starbuzzDatabaseHelper. 



new StarbuzzDatabaseHelper (this ) ; 



The Lo&t dorrt’mues ok -the Ke*i page — ^ 

Note: each thing from 
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cursor = db . query ( "DRINK" , 

new String [ ] { } , 

null, null, null, null, null) ; 



CursorAdapter listAdapter = new (this, 

android. R. layout . simple_list_item_l , 



new String [ ] { } , 

new int []{ android. R. id. textl } , 

0 ) ; 

listDrinks . setAdapter (listAdapter) ; 



} catch ( e) { 

Toast toast = Toast .makeText (this, "Database unavailable". Toast . LENGTH_SHORT) ; 
toast . show ( ) ; 



} 

} 

QOverride 

public void onDestroy(){ 
super . onDestroy ( ) ; 

. close ( ) ; 

. close ( ) ; 

} 



□ 

Starbuzz 

423 

app/src/main 

423 

java_ 

com . hfad .starbuzz 




DrinkCategory 

0 Override Activity.java 

public void onListltemClick (ListView listView, 

View itemView, 
int position, 
long id) { 

Intent intent = new Intent (DrinkCategoryActivity . this, DrinkActivity . class ) ; 
intent . putExtra (DrinkActivity . EXTRA_DRINKNO, (int) id) ; 
startActivity (intent) ; 



} 



you are here ► 
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Poo] puzz]e Solution 

Your job is to take code segments from the 
pool and place them into the blank lines 
in DrinkCategory Activity. java. You may 
not use the same code segment more 
than once, and you won't need to use 
all the code segments. Your goal is 
to populate the ListView with a list of 
drinks from the database. 



public class DrinkCategoryActivity extends ListActivity { 

private SQLiteDatabase db; 
private Cursor cursor; 

@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 

ListView listDrinks = getListView ( ) ; 

/ You yt a v*e*Pi ccttitt io da*labase 

us'mj a 

SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper (this) ; 
db = starbuzzDatabaseHelper. getReadableDatabasef) ; 




□ 

Starbuzz 



app/src/main 

L C3 



java 



4T 



com. hfad. starbuzz 

LE 



DrinkCategory 

Activity.java 
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The Cursor must include -the Jd dolwmir,, or -the 
adapter won't work. It must also include the NAME 
Column SO that we tan display a list °+ drmk names. 

cursor = db . query ( "DRINK" , ^ 

new String [] {"Jd", J 

null, null, null, null, null) ; 

WfeVe using a Si^pleCuirsorAdaptev'-. 

CursorAdapter listAdapter = new Simple^ (this, 

android. R. layout . simple_list_item_l , 

, . _ . j. ..A cursor , A/ pisplay the Contents 

new String [] {"NAME" }, o£ the NAM^ ^olumr\. 

new int []{ android. R. id. textl } , 

0 ) ; 

listDrinks . setAdapter (listAdapter) ; 

^ ' It the database is unavailable, we'll catch the SQLiteE*Ception. 

} catch ( SQLiteException e) { 

Toast toast = Toast .makeText (this, "Database unavailable". Toast . LENGTH_SHORT) , 
toast . show ( ) ; 



} 



QOverride 

public void onDestroy(){ 
super . onDestroy ( ) ; 

cursor .... • close ( ) '• Close the Cursor betore you 



□ 

Starbuzz 

HU 

app/sre/main 

HU 



java 



db 



. clos 



e ( ) ; <4^ tlose the database- 



HU 



com . hfad . starbuzz 

i_a 



DrinkCategory 

@ Override Activity.java 

public void onListltemClick (ListView listView, 

View itemView, 
int position, 
long id) { 

Intent intent = new Intent (DrinkCategoryActivity . this, DrinkActivity . class ) 
intent .putExtra (DrinkActivity . EXTRA_DRINKNO, (int) id) ; 
startActivity (intent ) ; 



} 
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DrinkCategoryActivity code 



The revised code for PriwkCategoryActivity 



V 

-►0 



Here’s the full code for DrinkCategoryActwity.java, replacing the 
array adapter with a cursor adapter (the changes are in bold): 



Drill kActivity 

DrinkCategoryActivity 

Favorites 



package com. hfad . starbuzz ; 



import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 



android 

android 

android 

android 

android 

android 

android 

android 

android 

android 

android 

android 

android 



. app . ListActivity; 
. content . Intent; 

. os . Bundle; 

. view .View; 

. widget . ListView; 

. database . Cursor ; 



□ 

Starbuzz 

app/sre/main 

4H 

java_ 

■ 

com. hfad. starbuzz 

U 



. database . sqlite . SQLiteDatabase ; 

. database . sqlite . SQLiteException ; 

. database . sqlite . SQLiteOpenHelper ; 
. widget . CursorAdapter ; 

. widget . SimpleCursorAdapter ; 

. widget . Toast ; 

. widget . SimpleCursorAdapter ; 



DrinkCategory 

Activity.java 



WeVe using -these e*ira classes, 
so you need -to impov-t -them. 



public class DrinkCategoryActivity extends ListActivity { 

private SQLiteDatabase db; 

private Cursor cursor; adding -these as private variables so vie tan dlose 

■the database and tursor in our onPestroyO method 

QOverride 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 

ListView listDrinks = getListView ( ) ; 



try { 

SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper (this) ; 
db = starbuzzDatabaseHelper . getReadableDatabase () ; 

^ a re-P e\ren£e 

cursor = db . query ( "DRINK" , "to "the database- 

^ new String [] { "_id" , "NAME"}, 

Create the dursor. 

null, null, null, null, null); 

The Lo&t £on-tmues on -the ne*-t page- 
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The PrinkCategoryActivity code (continued) 



Create the Cursor adapter. 

(C 



CursorAdapter listAdapter = new S impleCursorAdap ter (this , 



android . R . layout . simple_lis t_i tem_l , 
cursor, 



Map the Contents of the NAME 



new String [] {"NAME"} , 



tolwn to the text in the ListView. -^new int[] { android . R . id . textl } , 

0 ) ; 

listDrinks.setAdapter (listAdapter) ; WeVe still using an adapter, but 
itch (SQLiteException e) { this time it’s a Cursor adapter. 

Toast toast = Toast .makeText (this , "Database unavailable". Toast . LENGTH_SHORT) 
toast . show () ; 



Intent intent = new Intent (DrinkCategoryActivity . this , DrinkActivity . class ) ; 
intent . putExtra (DrinkActivity . EXTRA_DRINKNO, (int) id) ; 
startActivity (intent) ; 



} 





Starbuzz 




@ Override 



app/src/main 




public void onDestroy(){ 
super . onDestroy ( ) ; 
cursor . close ( ) ; 
db. close () ; 




com . hfad . starbuzz 




} 



DrinkCategory 

Activity.java 



QOverride 

public void onListltemClick (ListView listView 



1/Ve didn t need to 
Change “this method- 



View itemView, 
int position, 
long id) { 



Let’s try running the app. 
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Test drive the app 

Make the changes to the code, and then build and redeploy the app. 
When you do that, you’ll see that the app looks exactly the same as before. 



v 

-H3 



Diin kActivity 

DrinkCategoryActivity 

Favorites 



IZZ 



me ofht 


Latte 


Food 


Cappuccino 

Filter 


Stores 






* A 1 20:47 



Latte 

Espresso and steamed milk 



But now the data is being read from the database. In fact, you 
can now delete the Drink.java code, because we no longer 
need the array of drinks. Every piece of data we need is now 
coming from the database. 



VVKcr\ we run tbe app, we $ct 
the same results as before, 
but this tiw»e all tbe data is 
fcomi n$ -from tbe Starbuz-z. 
database. 



Where we've got to 



Here’s the current state of the Starbuzz app: 



— 

<Layou-t> | 

</Layou-fc> 

— — ' 

ac t i ■ v i ty_to p_l eve I .xm I 




There’s one more change we’re going to make to the app. 
We’re going to get the app to update data in the database. 




DnnKACTiviTy.java 



DnnkcategoryActivity.java 

We've t banged tbe activities that 
access tbe Drink class so that they 
use tbe database instead- 
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Put important information in the top-level activity 



When we first created our Starbuzz app, we designed the top-level 
activity to be very simple. The top-level activity is the first activity that 
the user sees when they launch your app, and all the Starbuzz one 
contains is an image and three navigation items which could be moved 
into a navigation drawer. It’s a good idea to keep your user interface 
simple, but is this too simple? 

The design of your top-level activity needs careful thought, as it’s the 
first thing that your user sees. Ideally, it should contain content that’s 
useful for new and existing users. One way of achieving this is to think 
about what your users will want to do in your app, and then give them 
a means of doing this from the front screen. As an example, if you 
were designing an app to play music, you might want to include the 
most recent albums the user has played in the top-level activity so that 
they’re easy for the user to find. 



We’re going to change the Starbuzz top-level activity by adding the 
users favorite drinks to it, and allowing them to click straight through to 
the drink they select. 



These items ideally 
belong in 3 navigation 
drawer. WeVe not 
going to add a 
navigation drawer to 
the Starbuzz. app, as 
navigation drawer 
dode is a bit involved 
and we want you to 
-fodus on databases. 



^tarlbuzz 

\mcofht 




We’ll add a ListView 
to TopLevc I Activity, 






Your fa rite drinks: 

Latte 



whidh dontains the 
user's -favorite drinks. 







When the user dlidks on a drink, it 
takes them through to that drink s 
details in pri nk Activity- 




.atte 

ispresso and steamed milk 
Q Favorite 



Users dan say whidh drinks are 
their -favorites by tidking a 
dhedkbox. We need to add this 
to DrinkAdtivity and get it to 
update the database. 




To do this, we first need to allow users to say which drinks are 
their favorites. 
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Add favorites to PrinkActivity 

In Chapter 1 1, we added a FAVORITE column to the DRINK table 
in the Starbuzz database. We’ll use this column to let users indicate 
whether a particular drink is one of their favorites so that we know 
which drinks to display in TopLevelActivity. We’ll let users 
edit drinks within DrinkActivity, as this activity displays details 
of the drink. 

To do this, we need to add a new view to activity _drink. xml that will be 
used to edit and display the value of the FAVORITE column. The 
type of view you use in a layout depends on what type of data you 
need to use it for. We need a view that will allow the user to choose 
true/ false values, so we’re going to use a checkbox. 

First, add a String resource called favorite to strings.xml (we’ll use 
this as a label for the checkbox): 

<s tr ing name= " f avor i te " >Favor i te</ s tr ing> 

Then add the checkbox to activity _drink. xml. We’re giving it an ID 
of favorite, and using its android: text attribute to display 
its label. We’re also setting its android: onClick attribute to 
M onFavoriteClicked M so that the o n Favor iteCli eked ( ) method in 
DrinkActivity will be called when the user clicks on the checkbox. 




DrinkActivity 

DrinkCategoryActivity 

Favorites 




.atte 

ispresso and steamed milk 
Q Favorite , 



We I! add a eheekbo* so 
usevs dan vedovd theiv 
•favoH-tes. 




<LinearLayout ...> 

<ImageView android: id="@+id/photo" 

. . . /> 






□ 

Starbuzz 



HT 3 



-These av-e -the photo, name, 

app/sre/main 

^ and desdviption views | p— j 

<TextView android : id=" @+id/name" ^ addcd ^ ^ | J 



/> 






dveated ike adiiviiy. 



<TextView android: id=" @+id/description" 

... /> 



to 

LQ 

layout 



activity_drink.xml 

. ^^The dheekbo* has an IP o£ -favorite- 

<CheckBox android: id="@+id/favorite" ^ — 

android : layout_width="wrap_content " 

android : layout_height= M wrap_content M 

android: text="@string/favorite" ' “to give the ehedkbox a label- 

android: onClick= M onFavoriteClicked M /> When *the dhetkbo* is d-lieked, the 

</LinearLayout> or ^ 



» nen xnc - 

nFavoriteCkkedO method will get called- 
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Add a new column to the cursor 

The next thing is to change the DrinkActivity code so that the 
favorite checkbox displays the value of the FAVORITE column 
that’s in the database. 

We can retrieve the value of the FAVORITE column in the same 
way that we did for the other views in the activity by adding the 
FAVORITE column to our cursor. We can then retrieve the value 
of the FAVORITE column from the cursor, and set the value 
of the checkbox to that value. Here’s the relevant part of the 
onCreate ( ) method: 

protected void onCreate (Bundle savedlnstanceState) 



□ 

Starbuzz 

HT3 

app/src/main 

ma 



java_ 

com. hfad. starbuzz 




DrinkActivity.java 



SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper ( this ) ; 
SQLiteDatabase db = starbuzzDatabaseHelper . getReadableDatabase () ; 

Cursor cursor = db. query ("DRINK", 

new String [] { "NAME" , "DESCRIPTION" , " IMAGE_RESOURCE_ID" , "FAVORITE" } , 



"_id = ?", 

new String [] { Integer . toString (drinkNo) } , 

null, null, null); 



Add -the FAVORITB 

Column -to -the Cursor. 



} 



//Move to the first record in the Cursor 
if (cursor .moveToFirst () ) { 

//Get the drink details from the cursor 
String nameText = cursor . getString ( 0 ) ; 

String descriptionText = cursor . getString ( 1 ) ; 

int photold = cursor . getlnt (2 ) ; £jet “the value o( *the F/W/ORITE 

boolean isFavorite = (cursor . getlnt (3) == 1) ; dolumn. |t*s stored m the database 

as I -for true, O (or -false. 



//Populate the favorite checkbox 

CheckBox favorite = (CheckBox) findViewByld (R. id. favorite) ; 
favorite . setChecked (isFavorite) ; ^ 

Set the value o( the 
-favorite eheekbo*. 



That’s enough to make sure the value of the FAVORITE column 
is displayed in the checkbox. Next, we need to get the checkbox to 
update the database when it’s clicked. 
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Respond to clicks to update the database 

When we added the checkbox to activity _drink. xml, we set the 
android : onClick attribute to onFavor iteClicked ( ) . 

This means that whenever the checkbox is clicked, the 
on Favor iteClicked ( ) method in the activity will get called. 

We need to get this method to update the database with the current 
value of the checkbox. If the user checks or unchecks the checkbox, 
the onFavor iteClicked ( ) method will get called and the user’s 
change will be saved to the database. 

In Chapter 1 1, you saw how to use SQLiteDatabase methods to 
change the data held in a SQLite database. You saw how to use the 
insert ( ) method to insert data, the delete ( ) method to delete 
data, and the update ( ) method to update existing records. 

You can use these methods to change data from within your activity. 

As an example, you could use the insert ( ) method to add new 
drink records to the DRINK table, or the delete ( ) method to 
delete them. In our case, we want to update the DRINK table’s 
FAVORITE column with the value of the checkbox, and we can do 
this using the update ( ) method. 

As a reminder, the update ( ) method takes the following form: 

database . update (String table , 

ContentValues values , 

String whereClause, 

String [] whereArgs) ; 

where table is the name of the table you want to update, and 
values is a ContentValues object containing name /value pairs 
of the columns you want to update and the values you want to set 
them to. The whereClause and whereArgs parameters specify 
which records you want to update 

You already know everything you need to get DrinkActivity 
to update the FAVORITE column for the current drink when the 
checkbox is clicked, so have a go at the following exercise. 




DrinkActivity 

DrinkCategoryActivity 

Favorites 




DrinkActivity 



Starbuzz 

database 
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Code Magnets 

In our code for DrinkActivity we want to update the FAVORITE 
column in the database with the value of the favorite checkbox. Can 
you construct the onFavoriteClicked ( ) method so that it will 
do that? 

public class DrinkActivity extends Activity { 

//Update the database when the checkbox is clicked 

public void onFavoriteClicked ( ){ 

int drinkNo = ( Integer ) getlntent (). getExtras (). get (EXTRA_DRINKNO) ; 
CheckBox favorite = (CheckBox) findViewByid (R . id . favorite ) ; 




drinkValues = new 



drinkValues . put ( 



favorite . isChecked ( ) ) ; 



SQLiteOpenHelper starbuzzDatabaseHelper = 

new StarbuzzDatabaseHelper (DrinkActivity . this ) ; 



try { 



SQLiteDatabase db = starbuzzDatabaseHelper. 
db . update ( , , 



, new String [ ] { Integer . toString (drinkNo) }) ; 



db . close ( ) ; 

} catch (SQLiteException e) { 

Toast toast = Toast .makeText (this, "Database unavailable". Toast . LENGTH_SHORT) ; 
toast . show ( ) ; 



drinkValues 



} "FAVORITE" 


l — 




I 1 View view 1 " id = ?" 

"nPTTttv" \ 1 — 




1 


i 


J” getWritableDatabase^^ 


1 getReadableDatabase ( ) | 



] 



ContentValues 



J~ favorite I 
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Code Magnets Solution 




In our code for DrinkActivity we want to update the FAVORITE 
column in the database with the value of the favorite checkbox. Can 
you construct the onFavoriteClicked ( ) method so that it will 
do that? 



DrinkActivity 

DrinkCategoryActivity 

Favorites 



public class DrinkActivity extends Activity { 



//Update the database when the checkbox is clicked 



public void onFavoriteClicked ( I View view 



int drinkNo = ( Integer ) getlntent (). getExtras (). get (EXTRA_DRINKNO) , 
CheckBox favorite = (CheckBox) findViewByid (R. id. favorite) ; 



ContentValues 



drinkValues .put ( 



drinkValues = new 



ContentValues () 



'FAVORITE" | , favorite . isChecked ()) ; 



} 



SQLiteOpenHelper starbuzzDatabaseHelper = 

new StarbuzzDatabaseHelper (DrinkActivity . this ) ; 



try { 



SQLiteDatabase db = starbuzzDatabaseHelper. | getWritab leDatabase () 

T 

1/Ve r\eed v-ead/ write access -to 
tbe database to update it- 

"__id = ?" ^ , new String [] { Integer . toString (drinkNo) }) ; 

db . close ( ) ; 

} catch (SQLiteException e) { 

Toast toast = Toast .makeText (this, "Database unavailable". Toast . LENGTH_SHORT) ; 
toast . show ( ) ; 

} 



db . update ( 



"DRINK" 



drinkValues 
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The PrinkActivity code 



Here’s the full code for DrinkActivity.java (changes are in bold): 



package com. hfad. starbuzz ; 



import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 



android . app . Activity; 

android . os . Bundle ; 

android . widget . ImageView; 

android . widget . TextView; 

android . widget . Toast; 

android . database . Cursor; 

android . database . sqlite . SQLiteDatabase; 

android . database . sqlite . SQLiteException; 

android . database . sqlite . SQLiteOpenHelper; 

android, view. View; > 

. We v-e using 

android . widget . CheckBox ; 
android . content . ContentValues ; 



-these e^tva diasses. 



□ 

Starbuzz 

app/src/main 

4U 



java_ 

com. hfad. starbuzz 




DrinkActivity.java 



public class DrinkActivity extends Activity { 



public static final String EXTRA_DRINKNO = "drinkNo"; 



@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_drink) ; 



//Get the drink from the intent 

int drinkNo = ( Integer ) getlntent (). getExtras (). get (EXTRA_DRINKNO) ; 



You r\eed vead/ wvi-te addess -to 
-the da-tabase -to update it 



//Create a cursor 
try { 

SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper (this ) ; 
SQLiteDatabase db = starbuzzDatabaseHelper . getWritableDatabase () ; ^ 

Cursor cursor = db. query ("DRINK", 

new String [] { "NAME" , " DESCRIPTION" , "IMAGE RESOURCE ID", "FAVORITE 




id = ?" 






new String [] { Integer . toString (drinkNo) } , 

null, null, null); 



Add the FfiVORlTB 

Column to "the dwvsov. 



//Move to the first record in the Cursor 
if (cursor .moveToFirst () ) { 



//Get the drink details from the cursor 
String nameText = cursor . getString ( 0 ) ; 

String descriptionText = cursor . getString ( 1 ) ; 
int photold = cursor . getlnt (2 ) ; 

boolean isFavorite = (cursor . getlnt (3) == 1) ; 

(\ck. -the value o-f the BfiiVOR\TB dolum*- 



The dode don-tinues 
oh -the ne*-t page- 
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The PrinkActivity code (continued) 




//Populate the drink name 

TextView name = (TextView) findViewByld (R . id . name ) ; 
name . setText (nameText) ; 



DrinkActivity 

DrinkCategoryActivity 

Favorites 



//Populate the drink description 

TextView description = (TextView) findViewByld (R. id. description) ; 
description . setText (descriptionText ) ; 

//Populate the drink image 

ImageView photo = (ImageView) findViewByld (R. id. photo) ; 
photo . setlmageResource (photold) ; 
photo . setContentDescription (nameText) ; 

//Populate the favorite checkbox 

CheckBox favorite = (CheckBox) findViewByld (R. id. favorite) ; 
favorite . setChecked (isFavorite) ; ^ 

} ; Populate the £he£kbo%- 

cursor . close ( ) ; 
db . close ( ) ; 

} catch (SQLiteException e) { 

Toast toast = Toast .makeText (this, "Database unavailable". Toast . LENGTH_SHORT) ; 
toast . show ( ) ; 

} 

} 



//Update the database when the checkbox is clicked 
public void onFavoriteClicked (View view) { 

int drinkNo = (Integer) getlntent () .getExtras() . get ("drinkNo" ) ; 

CheckBox favorite = (CheckBox) findViewByld (R. id. favorite) ; 

ContentValues drinkValues = new ContentValues () ; •, ,, . . C l P 

drinkValues . put ( "FAVORITE" , favorite . isChecked ());< V ,/ \ V , e , , Vo ' r ' . 

SQLiteOpenHelper starbuzzDatabaseHelper = C V " m a wes wtei^U/alues objeit- 

new StarbuzzDatabaseHelper (DrinkActivity . this) ; 

try { 



Update the 
FAVOKITB _ 

Column to the 
value o-P the 
£he£kbox- } 



SQLiteDatabase db = starbuzzDatabaseHelper . getWritableDatabase () ; 

^►db . update ( "DRINK" , drinkValues , 

"_id = ?", new String [] { Integer . toString (drinkNo) }) ; 

db. close () ; 

catch (SQLiteException e) { 

Toast toast = Toast .makeText (this , "Database unavailable". Toast . LENGTH_SHORT) 
toast . show () ; 

Display a message i*f there’s a problem with the database- 
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Pisplay favorites in TopLevel Activity 

The final thing we need to do is display the user’s favorite drinks in 
TopLevel Activity. 



o 

o 

o 



We need to add a new ListView to the layout. 

This will display a list of the user’s favorite drinks. 

We need to populate the ListView. 

We’ll populate the list with the user’s favorite drinks from the database. 

We need to get the ListView to respond to clicks. 

If the user clicks on one of their favorite drinks, we’ll display details of 
the drink in DrinkActivity. 



Applying all of these changes will enable us to display the user’s 
favorite drinks in TopLevelActivity. 



V A Q 16:27 



Starbuzz 

database 



The -favorites ListView 
will $et its data -from the 
database usinj a Cursor. 

v 




S+aHbwzz 

Wf Coffee 

Drinks 

Food 

Stores 

Your favorite drinks: 

Latte 



The items in the 
-favorites ListView need 
to respond to dieks. 




atte 

Espresso and steamed milk 

Q Favorite 




Over the next few pages, we’ll go through the code to do this. 
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Pisplay the favorite drinks in 
activity_topJevel.xnil 

As we said on the previous page, we’re going to add a list view 
to activity _top_lev el. xml, which we’ll use to display a list of the 
user’s favorite drinks. We’ll also add a text view to display a 
heading for the list. 

First, add the following String resource to strings. xml (we’ll use 
this for the text view’s text): 

<string name=" favorites ">Your favorite drinks :</string> 



Next, update activity _top_lev el. xml to add the text view and list 
view like this: 



<LinearLayout . . 

<ImageView 
android : 
android : 
android : 
android : 

<ListView 

android : 
android : 
android : 
android : 

<TextView 

android : 
android : 
android : 
android : 
android : 



v 

v/ 



DrinkActivity 

DrinkCategoryActivity 

Favorites 




4ZZ 

'Coffee 



Drinks 

Food 

Stores 

Vour favorite drinks: 

Latte 



layout_width="2 OOdp" 
layout_height= M lOOdp" 
src="@drawable/ starbuzz_logo" 

contentDescription=" @string/ starbuz z_logo" /> 



□ 



id="@+id/list_options" kT* 
layout_width="match_parent" 
layout_height="wrap_content " 
entries="@array/options" /> 



Starbuzz 

HZ3 

app/src/main 

The layout already Contains the 4Z3 
Stavbuzz. logo 5hd list view. re | S 

layout 



We'll add a te*t view to display the 

layout_width="wrap_content" drinks”- We'll put 

layout_height="wrap_content" ^ )S m a tailed tavorites. 

layou t_marginTop= " 5 Odp " 

textAppearance= M ?android: attr/textAppearanceLarge" 
text="@ string/favorites" /> 



activity_ 

topjevel.xml 



<ListView 

android: id= M @+id/list_favorites" 
android : layout_width="match_j?arent" 



-The list__ -Pavov-itcs 
List\/iew will 



android: layou t_height= M wrap_con tent" /> display the usev^s 

</LinearLayout> -favorite drinks. 



Those are all the changes we need to make to activity _top_lev el. 
xml. Next, we need to update TopLevelActivity.java. 
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What changes are needed for 
T oplevel Activityjava 

The next thing we need to do is display the users favorite drinks 
in the list view we just added, and get the list view to respond to 
clicks. To do this, we need to do the following: 



o 



We need to create a cursor to populate the ListView. 

The cursor will return all drinks where the FAVORITE column has 
been set to 1 — all drinks that the user has flagged as being a favorite. 
Just as we did in our code for DrinkCategoryActivity, we can 
connect the cursor to the ListView using a Curs or Adapter. 




Q 



We need to create an onltemClickListener so that the 
ListView can respond to clicks. 

If the user clicks on one of her favorite drinks, we can create an intent 
that starts DrinkActivity, passing it the ID of the drink that was 
clicked. This will show the user details of the drink they Ve just chosen. 




TopLevel Activity DrinkActivity 



You’ve already seen the code you need to do this, so over the 
next few pages, we’ll give you the full code for TopLevelActivity. 
java. 
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The new top-level activity code 

Here’s the new code we need to add to TopLevelActivity.java (there’s a lot 
of new code, so go through it carefully and take your time): 




Drill kActivity 

DrinkCategoryActivity 

Favorites 



package com. hfad. starbuzz; 



□ 

Starbuzz 



import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 



android . app . Activity; 
android . content . Intent ; 
android . os . Bundle ; 
android . widget . AdapterView; 
android. widget . ListView; 

android, view .View; 

android . database . Cursor ; N. 

android . database . sqlite . SQLiteOpenHelper ; 

android . database . sqlite . SQLi teException ; / 

android . database . sqlite. SQLiteDatabase ; using all "these 

android. widget . SimpleCursorAdapter; \ ey.-tva classes. 

android . widget . CursorAdapter ; J 

android, widget .Toast; 



Hn 

app/sre/main 

HZ3 

java_ 

m 

com . hfad .starbuzz 




TopLevel 

Activity.java 



public class TopLevelActivity extends Activity { 



private SQLiteDatabase db; 



private Cursor favorites Curs or 






IfVeVe adding these as private variables so that we have 
access to them in the onPestroyO method- 



@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_top_level ) ; 



The Code dontmues 
oh -the nex-t page- 
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The TopLevelActivity code (continued) 



□ 

Starbuzz 



//Create an OnltemClickListener for the Options ListView 
AdapterView. OnltemClickListener itemClickListener = 
new AdapterView . OnltemClickListener ( ) { 

public void onltemClick (AdapterView<?> listView, 

View v, 
int position, 
long id) { 

if (position == 0) { 

Intent intent = new Intent (TopLevelActivity . this , 
DrinkCategoryActivity. class) ; 
startActivity (intent) ; 



app/src/main 

ma 



java 






com. hfad. starbuzz 

H§ 

TopLevel 

Activity.java 



} 



V- 



} 



-This is Lode we ovitynally had in ouv 
onCveateO r*et hod. It populates the options 
} ; list view and $ets the list view to respond to 

dlidks. We still need this tode. 

//Add the listener to the Options ListView ^ 

ListView listView = (ListView) f indViewByld (R. id. list_options) ; 
listView . setOnltemClickListener ( itemClickListener) ; 

6\ti the -favorites list view . 

//Populate the list_favorites ListView from a cursor \L 

ListView listFavorites = (ListView) findViewById(R. id. list_favorites) ; 

try{ 

SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper (this) ; 
db = starbuzzDatabaseHelper . getReadableDatabase () ; 
favorite sCursor = db . query ( "DRINK" , 

V new String [] { "_id" , "NAME"}, 

flT+k l "FAVORITE = 1" , < ^e *ames of the user's 

vaUs^the nUl1 ' nUl1 ' nUl1 ' null); favorite drinks. 

_id and HAMB 

Columns where 

FAmiTB-l. 



The Code Continues ^ ^ 
on -the next page 
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The Toplevel Activity code (continued) 



V 

v/ 



DrinkActivity 

DrinkCategoryActivity 

Favorites 



new SimpleCursorAdapter (TopLevel Activity . this , 



CursorAdapter favoriteAdapter = 

t 

Msc the £uv-sov ih android. R. layout . simple list item 1 , 

the ^u\rso\r adapter. ” ” ” 

favorites Curs or , 



Display tke names of tke new String [ ] { "NAME" } , 
drinks in tke ListView- new int []{ android . R . id . textl } , 0); 

listFavorites . setAdapter (favoriteAdapter) ; 

} catch (SQLiteException e) { 

Toast toast = Toast .makeText (this , "Database unavailable " , Toast. LENGTH SHORT); 



toast. show () ; 



} 



Display a message i*P •IhevVs a problem wi*lh *lhe da*labase 

This will <jei tailed i-P a* i-tem 
in -the lis-t View is disked- 



//Navigate to DrinkActivity if a drink is clicked 
listFavorites . setOnltemClickListener (new AdapterView.OnltemClickListener () { 

©Override 

public void onltemClick (AdapterView<?> listView, View v, int position, long id) 



} 



}) 



Intent intent = new Intent (TopLevel Activity. this , DrinkActivity . class) ; 
intent . putExtra (DrinkActivity . EXTRA_DRINKNO , (int) id) ; 
s tar tActivity (intent) ; ^ 

} |f tke user dlidks on one of ike items in ike 

favorites ListView, dreaie an '"^nt to start starbuzz 
py-inkAdtivity passing alonOj ike IP of ike drink- 



//Close the cursor and database in the onDestroyO method 
©Override 

public void onDestroyO { 
super .onDes troy () ; 

f avoritesCursor . close ( ) ; Close the £u rsor and database when the 

db. close () ; ***** i, <fc*-oytd. 



a 

buzz 

LQ 

app/sre/main 

L u 



java rt 

lo 

com . hfad .starbuzz 

L @ 

TopLevel 

Activity.java 



} 



The above code populates a list view with the user’s favorite drinks. When the user 
clicks on one of these drinks, an intent starts DrinkActivity and passes it the ID 
of the drink. Details of the drink are then displayed. We’ll show you this running on 
the next page, along with a problem we need to sort out. 
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Test drive the app 

When we open the app, the new text view 
and new favorites list view are displayed in 
TopLevelActivity, as you’d expect. No drinks 
are displayed in the list view because no drinks 
have been chosen as favorites yet. 


a • 


* A Q 16:09 ■ 


Sfarkuzz* 

mcofftt 

Drinks 

Food 

Stores 




The -favorites Listl/iew 
is here- It isn^t visible, as* — ^ 
there are no drinks in it 


Your favorite drinks: 






a ¥ 


ti Q 16:10 % 




When we navigate to DrinkActivity, a new 
checkbox is displayed. If we click on it, this flags 
that the drink is a favorite. 



ttev-e s the dhefckbo* 
added- Clitkinj on it 
updates the Starbuzz. - 
database. 



When we go back to TopLevelActivity, the drink we selected as 
a favorite isn’t displayed in the favorites list view. It only appears if we 
rotate the device. 



_atte 

Espresso and steamed milk 
D Favorite 








Why do you think the drink we chose as a favorite 
doesn’t appear in the list view until we rotate the 
screen? Think about this before turning the page. 



^tarfeuzz 

Coffee 

Drinks 

Food 

Stores 

Your favorite drinks: 



Still no drinks. What 
do you think happened? 
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out of date data 



Cursors don't automatically refresh 

If the user chooses a new favorite drink by navigating through the app to 
DrinkActivity, the new favorite drink isn’t automatically displayed in 
the favorites list view in TopLevel Activity. This is because cursors 
retrieve data when the cursor gets created. In our case, the cursor is 
created in the activity onCreate () method, so it gets its data when the 
activity is created. When the user navigates through the other activities, 
TopLevelActivity is stopped, not destroyed and re-created. 




DrinkActivity 

DrinkCategoryActivity 

Favorites 



/Cofft 



Drinks 

Food 

Stores 



Your favorite drinks 




_atte 

Espresso and steamed milk 

Q Favorite 



1/Vhen you start a setond 
activity, the setond activity 
is statked on top of the 
first- The -first activity isn't 
destroyed- Instead, its paused 
then stopped, as it loses the 
fotus and stops bein$ visible to 
the user. 



Cursors don’t automatically keep track of whether the underlying data in the 
database has changed. If the underlying data changes after the cursor’s been 
created, the cursor doesn’t get updated. It still contains the original records, 
and none of the changes. 



|f you update the data 
in the database- 



id 



1 

2 



NAME 



‘Latte” 



‘Cappucc ino” 



“Filter” 



id 



DESCRIPTION 



"Espresso and steamed milk" 
"Espresso, hot milk and 



NAME 



“Latte” 

“Cappuccino” 

“Filter” 



IMAGE RESOURCE ID 



54543543 



654334453 



DESCRIPTION 



"Espresso and steamed milk" 

"Espresso, hot milk and 
steamed-milk foam" 

"Our best drip coffee" 



FAVORITE 



IMAGE RESOURCE ID 



54543543 

654334453 

44324234 



•the Cursor won't 
see it if the tursor's 
already been treated. 



FAVORITE 



0 

0 

0 




So how do we get around this? 
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Change the cursor with changeCursorO 



The solution is to change the underlying cursor used by the favorites list 
view to a new version when the user returns to TopLevelActivity. 
If we do this in the activity’s on Re start () method, the 
data in the ListView will get refreshed when the user returns to 
TopLevelActivity. Any new favorite drinks the user has chosen 
will be displayed, and any drinks that are no longer flagged as favorites 
will be removed from the list. 



To do this, we can use the CursorAdapter changeCursor ( ) 
method. The changeCursor ( ) method replaces the cursor 
currently used by a cursor adapter to a new one, and closes the old 
cursor. Here’s what the method looks like: 



public void changeCursor (Cursor newCursor) 



This is -the new tursor Y ou ' wa "‘k 
-the dursor adapter to use 



The changeCursor ( ) method takes one parameter, the new cursor. 
Here’s an example of the code in action: 



//Create the new cursor 

StarbuzzDatabaseHelper starbuzzDatabaseHelper = new Starbuz zDatabaseHelper (this ) ; 
SQLiteDatabase db = starbuz zDatabaseHelper . getReadableDatabase () ; 

Cursor cursor = db . guery ( "DRINK", 

new String [] { "_id", "NAME"}, a new £uv-so\r in exactly 

"FAVORITE = 1 " , ^be w3y you did be-PoV-C- 

null, null, null, null) ; 



//Get the CursorAdapter used by the ListView 

ListView listFavorites = (ListView) findViewByld (R . id . list_f avorites ) ; You get the ListView's 

CursorAdapter adapter = (CursorAdapter) listFavorites . getAdapter () ; adapter using the 

getAdapterO method- 

//Change the cursor used by the CursorAdapter to the new one we just created 

adapter. changeCursor (cursor) ; ^ Change the Cursor used by the Cursor adapter to the new one- 

We’ll show you the revised code for TopLevelActivity.java on the next few 
pages. 
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The revised TopLevelActivity .java code 

Here’s the full TopLevelActivity.java code (our changes are in bold): 




Drill kActivity 

DrinkCategoryActivity 

Favorites 



package com. hfad. starbuzz ; 



public class TopLevelActivity extends Activity { 
QOverride 

protected void onCreate (Bundle savedinstanceState) 



□ 

Starbuzz 



4U 

app/src/main 



L o 



java 



>1 



MZ3 



} These methods haven't changed- 

V 

//Close the cursor and database in the onDestroyO method 
@Override 

public void onDestroyO { 



com. hfad. starbuzz 

Lil 



TopLevel 

Activity.java 



This jets called »ke» tKe user eetue.s t. Tof U«clActi«it/ 



public void onRestart() { 
super . onRe start () ; 
try{ 

StarbuzzDatabaseHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper (this) ; 
db = starbuzzDatabaseHelper . getReadableDatabase () ; 

Cursor newCursor = db . query ("DRINK", a hew Cursor i n exactly 

new String [] { "_id" , "NAME" } sarwC ^ay Y ou did be-Pore- 
"FAVORITE =1", 
null, null, null, null) ; 

ListView listFavorites = (ListView) findViewByld (R. id. list_favorites) ; 
CursorAdapter adapter = (CursorAdapter) listFavorites .getAdapter () ; 
adapter . changeCursor ( newCursor) ; * Change the Cursor used ^e list view's adapter. 

favoritesCursor = newCursor; the Cursor adapter 

to the hew ohe- 



} catch (SQLiteException e) { 

Toast toast = Toast .makeText (this , "Database unavailable", Toast. LENGTH_SHORT) ; 
toast . show () ; ^ 

} 



Pisplay a message 1 there's a problem with the database. 



} 

That’s all the code we need for our top-level activity. Let’s take it 
for a spin and see how it works. 
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Test drive the app 

This time when we flag a drink as being a favorite, it appears in 
TopLevelActivity. When we click on the drink, the app shows 
us the details of that drink. 



^f,vH&uzz 

Drinks 

Food 

Stores 

Your favorite drinks: 

The -favorites Listl/iew 
starts o-f-f empty* 




.atte 

ispresso and steamed milk 
Q Favorite 



l/Ve tick the eheekbo* 
to say that Latte is a 
-favorite drink. 



W Coffee 



n 



Drinks 



Food 



Stores 




Your favorite drinks: 

Latte 



k 

Latte appears in the 
List\/iev/ Y/hen Y/e ^o back 
to TopLevelActivity* 



_atte 

Espresso and steamed milk 
Q Favorite 

* 

When we diek on Latte 
in the TopLevdActivity, 
DrinkActivity is displayed 
shoY/ing details ot that 
drink- 




Databases are powerful, but they can be slow. 

That means that even though our app works, we need to keep 
an eye on performance... 
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meanwhile... 



databases can make your app go in sloooo-moooo.... 

Think about what your app has to do when it opens a database. It first 
needs to go searching through the flash to find the database file. If the 
database file isn’t there, it needs to go create a blank database. Then 
it needs to run all of the SQL commands to create tables inside the 
database and any initial data it needs. Finally, it needs to fire off some 
queries to get the data out of there. 

That takes time. For a tiny database like the one used in the Starbuzz 
app, it’s not a lot of time. But as a database gets bigger and bigger, that 
time will increase and increase. Before you know it, your app will lose 
its mojo and will be slower than YouTube on Thanksgiving. 

There’s not a lot you can do about the speed of creating and reading 
from a database, but there is a lot you can do to prevent it slowing up 
your interface. 

Life is better when threads work together 

The big problem with accessing a slow database is that can make your 
app feel unresponsive. To understand why, you need to think about 
how threads work in Android. Since Lollipop, there are three kinds of 
threads you need to think about: 

The main event thread 

This is the real workhorse in Android. It listens for intents, it receives touch messages from 
the screen, and it calls all of the methods inside your activities. 

The render thread 

You don’t normally interact with this thread, but it reads a list of requests for screen 
updates and then calls the low-level graphics hardware to repaint the screen and make 
your app look pretty. 

All of the other thread that you create 



o 

o 

o 



If you’re not careful, your app will do almost all of its work on the 
main event thread. Why? Because it’s the main event thread that runs 
your event methods. If you just drop your database code into the 
onCreate () method (as we did in the Starbuzz app) then the main 
event thread will be busy talking to the database, instead of rushing off 
to look for any events from the screen or other apps. If your database 
code takes a long time, users will feel like they’re being ignored. 

So the trick is to move your database code off the main event 
thread and run it in a custom thread in the background. 
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We're going to run the DrinkActivity database code in a 
background thread, but before we rush off and start hacking 
code, let's take a moment to think about what we need to do. 

The code that we have at the moment does three different things. 
Which thread do you think each block of code should run on? 
Choose the type of thread you think each should run on. 



© Set op the interface. 




super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_drink) ; 

int drinkNo = ( Integer ) getintent (). getExtras (). get (EXTRA_DRINKNO) ; 



Main event thread 


A background thread 


Talk to the database. 





Choose whether you think 
eadh blodk of dode should 



be run on the main event 
thread or a badktyround 
thread- 



SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper (this ) ; 
SQLiteDatabase db = starbuz zDatabaseHelper . getReadableDatabase ( ) ; 

Cursor cursor = db. query ("Drink",... 



Main event thread 


A background thread 







O Update the views with the database data. 



name . setText (...); 
description . setText (...); 
photo . setimageResource (...); 



Main event thread 


A background thread 







you are here ► 



527 
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Sharpen your pencil 
Solution 



We're going to run the DrinkActivity database code in a 
background thread, but before we rush off and start hacking 
code, let's take a moment to think about what we need to do. 

The code that we have at the moment does three different things. 
Which thread do you think each block of code should run on? 
Choose the type of thread you think each should run on. 



© Set up the interface. 



super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_drink) ; 

int drinkNo = ( Integer ) getlntent (). getExtras (). get (EXTRA_DRINKNO) ; 



Main event thread 


A background thread 


V 








We always create the user 
interface on the r»am thread- 



© Talk to the database. 



SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper (this ) ; 
SQLiteDatabase db = starbuz zDatabaseHelper . getReadableDatabase ( ) ; 

Cursor cursor = db. query ("Drink", . . . 

We want to run the database 
£ode in the background because 
it^s slow- 



Main event thread 


A background thread 







© Update the views with the database data. 



name . setText (...); 
description . setText (...); ^ 

photo . setimageResource (...); 



■ We must -to ri*n the Lode bo update the views on 
•the main thread, otherwise we jet an exception. 



Main event thread 


A background thread 
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What code goes on which thread? 

When you use databases in your app, it’s a good idea to run database 
code in a background thread, and update views with the database 
data in the main event thread. We’re going to work through the 
onFavoritesClicked ( ) method in the DrinkActivity code so 
that you can see how to approach this sort of problem. 

Here’s the code for the method (we’ve split it into sections, which we’ll 
describe below): 

//Update the database when the checkbox is clicked 
public void onFavoriteClicked (View view) { 



© 

© 

o 



int drinkNo = (Integer) getlntent ( ) .getExtras() . get (EXTRA_DRINKNO) ; 
CheckBox favorite = (CheckBox) findViewByld (R. id. favorite) ; 
ContentValues drinkValues = new ContentValues () ; 
drinkValues . put ( " FAVORITE " , favorite . isChecked ( ) ) ; 





© 

© 

© 



Code that needs to be run before the database code 

The first few lines of code gets the value of the favorite checkbox, and puts it in the 
drinkValues ContentValues object. This code must be run before the database code. 

Database code that needs to be run on a background thread 

This updates the DRINK table. 

Code that needs to be run after the database code 

If the database is unavailable, we want to display a message to the user. This must run 
on the main event thread. 



We’re going to implement the code using an AsyncTask. So what’s 
that, anyway? 
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AsyncTask performs asynchronous tasks 

The AsyncTask class lets you perform operations in the 
background. When they’ve finished running, it then allows you to 
update views in the main event thread. If the task is repetitive, you 
can even use it to publish the progress of the task while it’s running. 

You create an AsyncTask by extending the AsyncTask class, 
and implementing its doInBackground ( ) method. The 
code in this method runs in a background thread, so it’s the 
perfect place for you to put database code. The AsyncTask 
class also has an onPreExecute ( ) method that runs before 
doInBackground ( ) , and an onPostExecute ( ) method that 
runs afterward. There’s an onProgressUpdate ( ) method if 
you need to publish task progress. 

Here’s what it looks like: 

private class MyAsyncTask extends AsyncTask<Params , 

protected void onPreExecute ( ) { 

//Code to run before executing the task 

} 

protected Result doInBackground (Par ams .. . params) { 

//Code that you want to run in a background thread 

} 

protected void onProgressUpdate (Progress .. . values) { 

//Code that you want to run to publish the progress of your task 

} 

protected void onPostExecute (Result result) { 

//Code that you want to run when the task is complete 

} 

} 

AsyncTask is defined by three generic parameters: Params, 

Progress, and Results. Params is the type of object used to pass 
any task parameters to the doInBackground ( ) method, Progress is 
the type of object used to indicate task progress, and Result is the type 
of the task result. You can set any of these to Void if you’re not going to 
use them. 

We’ll go through this over the next few pages by creating a new 
AsyncTask called UpdateDrinkTask we can use to update drinks in 
the background. Later on, we’ll add this to our DrinkActivity code. 



android.os.AsyncTask 
<Params, Progress, Result> 

void onPreExecute () 

Result doInBackground (Params... params) 
void onProgressUpdate (Progress... values) 
void onPostExecute (Result result) 

AsyncTask<Params, Progress, Result> 
execute (Params... params) 



Pr ogr e s s , Re sul t> 



java.Iang.Object 

S 
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The onPreExecuteO method 

We’ll start with the onPreExecute ( ) method. This gets called 
before the background task begins, and it’s used to set up the 
task. It’s called on the main event thread, so it has access to views 
in the user interface. The onPreExecute ( ) method takes no 
parameters, and has a void return type. 

We’re going to use the onPreExecute ( ) method to get the 
value of the favorite checkbox, and put it in the drinkValues 
ContentValues object. This is because we need access to the 
checkbox in order to do this, and it must be done before any of our 
database code can be run. We’re using a separate attribute outside 
the method for the drinkValues ContentValues object so 
that other methods in the class can access it. 

Here’s the code: 




private class UpdateDrinkTask extends AsyncTask<Params, Progress, Result> { 

ContentValues drinkValues ; 

B (U we m the database Code, we need 

to <\et the value ot the tavovite dhetkbo* 
protected void onPreExecuteO { ^ -3 

CheckBox favorite = (CheckBox) findViewBy Id (R. id. favorite) ; 

drinkValues = new ContentValues () ; 

drinkValues . put ( "FAVORITE" , favorite . isChecked ( ) ) ; 

} 



Next, we’ll look at the doInBackground ( ) method. 
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The dolnPackgroundO method 

The doInBackground ( ) method runs in the background 
immediately after onPreExecute ( ) . You define what type of 
parameters the task should receive, and what the return type should 
be. 

We’re going to use the doInBackground ( ) method for our 
database code so that it runs in a background thread. We’ll pass it 
the ID of the drink we need to update, and we’ll use a Boolean 
return value, so we can tell whether the code ran successfully: 




private class UpdateDrinkTask extends AsyncTask<Integer, Progress, Boolean> { 



ContentValues drinkValues; 



7 

^/ou dhan^e “this to Integer to 
matdh the parameter o-C the 
do|nBadkyoundO method- 

This dode runs in a badkaround thread- 

"V 

protected Boolean doInBackground (Integer . . . drinks) { 



you dhanje this to Boolean to 
matdh the return type ot the 
do|nBadk<yroundO method- 

This is an array O-C Integers, 
but we II just indlude one item, 

"the drink IP- 



int drinkNo = drinks [0] ; 

SQLiteOpenHelper starbuzzDatabaseHelper = 

new StarbuzzDatabaseHelper (DrinkActivity . this) ; 

try { 

SQLiteDatabase db = starbuzzDatabaseHelper . getWritableDatabase () ; 
db . update ( "DRINK" , drinkValues , 

T "_id = ?", new String [] { Integer . toString (drinkNo) } ) 

db. close (); 

* The updateO method uses the 

return true; dvmkl/alue* objedt ih ai the 

} catch (SQLiteException e) { o»Pve£*eduteO method dveated- 
return false; 



} 



Next, we’ll look at the onProgressUpdate ( ) method. 
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The onProgressUpdateO method 

The onProgressUpdate ( ) method is called on the main event 
thread, so has access to views in the user interface. You can use this 
method to display progress to the user by updating views on the 
screen. You define what type of parameters the method should have. 

The onProgressUpdate ( ) method runs if a call to 
publishProgress ( ) is made by the doInBackground ( ) 
method like this: 

protected Boolean doInBackground (Integer .. . count) { 
for (int i = 0; i < count; i++) { 

publishProgress (i) ; ^_ TK|S u \\ % ^he onPro^ess MfdateO 
} method, passing in a value o£ i- 

} 



protected void onProgressUpdate (Integer .. . progress) { 
setProgress (progress [0] ) ; 

} 




onPreExecute 





doln&ackground 





onProgressUpdate 





onPostExecute 




We’re not publishing the progress of our task, so we don’t need 
to implement this method. We’ll indicate that we’re not using 
any objects for task progress by changing the signature of 
UpdateDrinkTask: 



WeVe not usincj the 
onPvoyessUp dateO 
method, SO this is Void- 



private class UpdateDrinkTask extends AsyncTas k< Integer , Void, Boolean> { 



Finally, we’ll look at the onPostExecute ( ) method. 
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The onPostExecuteO method 

The onPostExecute ( ) method is called after the 
background task has finished. It’s called on the main event 
thread, so has access to views in the user interface. You can use 
this method to present the results of the task to the user. The 
onPostExecute ( ) method gets passed the results of the 
doInBackground ( ) method, so must take parameters that 
match the doInBackground ( ) return type. 

We’re going to use the onPostExecute ( ) method to check 
whether the database code in the doInBackground ( ) 
method ran successfully. If it didn’t, we’ll display a message 
to the user. We’re doing this in the onPostExecute ( ) 
method as this method can update the user interface; the 
doInBackground ( ) method runs in a background thread, so 
can’t update views. 

Here’s the code: 




onPreExecute 





doInBackground 





onProgressUpdate 





onPostExecute 




private class UpdateDrinkTask extends AsyncTaskClnteger , Void, Boolean> { 

T 

This is Boolean, as owv doInBatky-oundO 
meihod v-etwns a Boolean- 



£ 



protected void onPostExecute (Boolean success) { 
if (! success) { 

Toast toast = Toast .makeText (DrinkActivity. 

"Database unavailable" 






Pass -the Toas-t -the 
D^nkA^tivi-ty £orrte*-t. 



this , 



, Toast . LENGTH_SHORT ) ; 



toast. show () ; 



} 



} 



} 
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The AsyncTask class 



When we first introduced the AsyncTask class, we said it was defined 
by three generic parameters: Params, Progress, and Results. 
You specify what these are by looking at the type of parameters 
used by your doInBackground ( ) , onProgressUpdate ( ) , 
and onPostExecute ( ) methods. Params is the type of the 
doInBackground ( ) parameters, Progress is the type of the 
onProgressUpdate ( ) parameters, and Result is the type of the 
onPostExecute ( ) method: 



private class MyAsyncTask extends AsyncTask<Params, Progress, Result> 



protected void onPreExecute () { 

//Code to run before executing the 



} 



protected Result doInBackground (Params 

//Code that you want to run in a background 

} 

protected void onProgressUpdate (Progress .. . values) { 

//Code that you want to run to publish the progress of your task 




} 



(<r 



protected void onPostExecute (Result result) { 

//Code that you wan to run when the task is complete 

} 



In our example, doInBackground ( ) takes Integer parameters, 
and onPostExecute ( ) takes a Boolean parameter. We’re not using 
the onProgressUpdate ( ) method. This means that in our example, 
Params is Integer, Progress is Void and Result is Boolean: 



private class UpdateDrinkTask extends AsyncTaskCInteger , Void, Boolean> { 



protected Boolean doInBackground (Integer .. . drinks) { 



} 



protected void onPostExecute (Boolean .. . success) { 
} 



You now know everything you need to create a task — let’s see how you run it. 
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Execute the AsyncTask 

You run the task by calling your AsyncTask’s execute ( ) method. If 
your doInBackground ( ) method takes parameters, you add these to the 
execute ( ) method. As an example, we want to pass the drink the user chose 
to the AsyncTask’s doInBackground ( ) method, so we call it using: 

int drinkNo = ( Integer ) getlntent (). getExtras (). get (EXTRA_DRINKNO) ; 

new UpdateDrinkTask ( ) . execute (drinkNo) ; 

The type of parameter you pass with the execute ( ) method must match the 
type of parameter expected by the AsyncTask doInBackground ( ) method. 

Our doInBackground ( ) method takes Integer parameters, so we need to 
pass integers: 

protected Boolean doInBackground ( Integer .. . drinks) { 



} 

We’re going to execute UpdateDrinkTask in DrinkActivity’s 
onFavoritesClicked ( ) method. Here’s what the method looks like: 



//Update the database when the checkbox is clicked 
public void onFavoriteClicked (View view) { 

int drinkNo = ( Integer ) getlntent (). getExtras (). get (EXTRA_DRINKN0) ; 

s f*r»w ^ ^ \ s vended 

V OI^TTlUU - "?a v or ' ^ by ouv fe'fntTdsk- 



< 



— tf/rrbiiT7nafTb/^pHp 1 pprY — ' 

npj^^ ^rb^ gTS la 1 pc r ( A .\ v i T7 y . U i i n ) - p * 

-s i m - Hni - i Tr tffih tabs s h.'> h d T ;f 1^ah jbn no H- s l . 
vdbu < <rn4at^d ,, n!) ^ ^ d^i^kVa -lues , — n^TTstrin^ Ll { I nt ^ee^ ^t o S ) : 



s l^rri i ^ t e^e r j ^t ( -^ h i-g^ — u ^laJa^bes^-^Hi^availaljTe* u -7 — Turret . LE NTIFH--8fTO^^ 



new UpdateDrinkTask () .execute (drinkNo) ; <- E*edute the AsyncTask a«d pass it the dtmk ID- 



We’ll show you the new DrinkActivity.java code on the next page. 
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The PrinkActivity-java code 

When you create an AsyncTask, you add it as an inner 
class to the activity that needs to use it. We’re going to 
add our UpdateDrinkTask class as an inner class to 
DrinkActivity.java. We’ll execute the task in DrinkActivity’s 
onFavoriteClicked ( ) method so that the task updates the 
database in the background when the user clicks on the favorite 
checkbox. 

Here’s the code: 



package com. hfad. starbuzz ; 



import android . os . AsyncTask ; Import the feyntTdsV. dlass. 



□ 

Starbuzz 

4T3 

app/src/main 



public class DrinkActivity extends Activity { 

• • • - We don't need to Change the onCveateO method, so we've le-ft it out- 



java „ 

4T3 

com. hfad. starbuzz 




DrinkActivity.java 

//Update the database when the checkbox is clicked 
public void onFavoriteClicked (View view) { 

int drinkNo = (Integer ) getlntent (). getExtras (). get (EXTRA_DRINKNO) ; 

new UpdateDrinkTask ( ) . execute (drinkNo) ; ^"£* C £ U t t the task- 



} 



//Inner class to update the drink. Asyhdlask to the activity as ah ihher dlass. 

private class UpdateDrinkTask extends AsyncTask<Integer , Void, Boolean> { 



ContentValues drinkValues ; 



Be-fov-e the database Code v-uns, put the value o-f the 
protected void onPreExecute ( ) { /T checkbox in the dvink Values ContentValues object- 
CheckBox favorite = (CheckBox) findViewByld (R. id. favorite) ; 
drinkValues = new ContentValues () ; 

drinkValues . put ( "FAVORITE" , favorite . isChecked ( ) ) ; 



} 



The dode dohtihues 
oh the he*t page- 
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The PrinkActivity-java code (continued) 

Run -the database code in a 

protected Boolean doInBackground (Integer. . . drinks) { background "thread- 

int drinkNo = drinks [0] ; 

SQLiteOpenHelper starbuzzDatabaseHelper = 

new StarbuzzDatabaseHelper (DrinkActivity . this) ; 

try { 

SQLiteDatabase db = starbuzzDatabaseHelper . getWritableDatabase () ; 
db . update ( "DRINK" , drinkValues , 



db . close ( ) ; 
return true; 

} catch (SQLiteException e) { 
return false; 

} 



"_id = ?", new String [] { Integer . toString (drinkNo) }) ; 

it 

Update the value of 



the FAVORITE Column- 



□ 

IUZZ 

HTJ 



Starbuzz 



protected void onPostExecute (Boolean success) { 
if (! success) { 

Toast toast = Toast .makeText (DrinkActivity . this, 

"Database unavailable". Toast. LENGTH SHORT); 



app/src/main 

MB 

java_ 

r □ 

com . hfad .starbuzz 

L i 

DrinkActivity.java 



toast, show () ; 






if the database Code didn't run OK 
display a message to the 



user. 



That’s everything you need in order to create an 
AsyncTask. When the user clicks on the favorite 
checkbox in DrinkActivity, the database gets 
updated in the background. 



In an ideal world, all of your 
database code should run in 
the background. We’re not 
going to change our other 
Starbuzz activities to do 
this, but why not have a go 
yourself? 



538 Chapter 12 



cursors and asynctasks 



A summary of the AsyncTask steps 




( doInBackground ) 



( onProgressUpdate ) 




Q : I’ve written code before that 
just ran the database code and it was 
fine. Do I really need to run it in the 
background? 

For really small databases, like the 
one in the Starbuzz app, you probably 
won’t notice the time it takes to access 
the database. But that’s just because 
the database is small. If you use a larger 
database, or if you run an app on a slower 
device, the time it takes to access the 
database will be significant. So yes, you 
should always run database code in the 
background. 



% Remind me - why is it bad to 
update a view from the background 
thread? 



o 



onPreExecute() is used to set up the task. 

It’s called before the background task begins, and runs on the 
main event thread. 



Q 



doInBackgroundQ runs in the background thread. 

It runs immediately after onPreExecute ( ) . You can specify 
what type of parameters it has, and what its return type is. 



o 



onProgressUpdate() is used to display progress. 

It runs in the main event thread when the 
doInBackground ( ) method calls publishProgress ( ) . 



o 



onPostExecuteO is used to display the task outcome 
to the user when doInBackground has finsihed. 

It runs in the main event thread. It takes the return value of 
doInBackground ( ) as a parameter. 



there-, ecce no 

Dumb Questions 



The short answer is that it will throw 
an exception if you try. The longer answer 
is that multi-threaded user interfaces are 
hugely buggy. Android avoided the problem 
by simply banning them. 

% Which part of the database code 
is slowest? Opening the database, or 
reading data from it? 

There’s no general way of knowing. 

If your database has a complex data 
structure, then the first time you open the 
database will take a long time because it 
will need to create all the tables. If you’re 
running a complex query, that might take a 
very long time. In general, play it safe and 
run everything in the background. 



Q If it take a few seconds to read 
data from the database, what will the 
user see? 



The user will see blank views until 
the database code sets the values. 



% Why have you put the database 
code for just one activity in an 
AsyncTask? 



^Z We wanted to show you how to 
use AsyncTasks in one activity as 
an example. In the real world, you should 
do this for the database code in all your 
activities. 
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Your Android Toolbox 



You’ve got Chapter 12 under 
your belt and now you’ve 
added connecting your app to 
SQLite databases to your toolbox. 



You tan download 
-the -full tode -fov 
the thaftev- £v-om 

httfs : //-ttnYuvUonf»/ 

Head? iv-stAndvoid- 




BULLET POINTS 



■ A Cursor lets you read from and 
write to the database. 

■ You create a cursor by calling the 
SQLiteDatabase query ( ) 
method. Behind the scenes, this builds 
a SQL SELECT statement. 



■ The getWritableDatabase ( ) 

method returns a 
SQLiteDatabase object that 
allows you to read from and write to 
the database. 

■ The getReadableDatabase ( ) 
returns a SQLiteDatabase 

object. This gives you read-only 
access to the database. It may also 
allow you to read from and write to the 
database, but this isn’t guaranteed. 

■ Navigate through a cursor using the 

moveTo* () methods. 

■ Get values from a cursor using the 
get* ( ) methods. 



Close cursors and database 
connections after you've finished with 
them. 

A CursorAdapter is an 

adapter that works with cursors. 

Use SimpleCursorAdapter 

to populate a Listview with the 
values returned by a cursor. 

Design your app so that you put useful 
content in your top-level activity. 

The CursorAdapter 
changeCursor ( ) method 
replaces the cursor currently used by 
a cursor adapter to a new cursor that 
you provide. It then closes the old 
cursor. 

Run your database code in 
a background thread using 

AsyncTask. 
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* At Your Service + 

7S 




There are some operations you want to keep on running, 
irrespective of which app has the focus. 

As an example, If you start playing a music file in a music app, you’d probably expect it 
to keep on playing when you switch to another app. In this chapter, you’ll see how to use 
services to deal with situations just like this. Along the way, you’ll see how to use some 
of Android’s built-in services. You’ll see how to to keep your users informed with the 
notification service, and how the location service can tell you where you’re located. 



this is a new chapter 
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Services work behind the scenes 

An Android app is a collection of activities and other 
components. The bulk of your code is there to interact with the 
user, but sometimes you need to do things in the background. 
You might want to download a large file, stream a piece of 
music, or listen for a message from the server. 

These kinds of tasks aren’t what activities are designed to do. In 
simple cases, you can create a thread, but if you’re not careful 
your activity code will start to get complex and unreadable. 

That’s why services were invented. A service is an application 
component like an activity but without a user interface. They 
have a simpler lifecycle than an activity, and they come with a 
bunch of features that make it easy to write code that will run in 
the background while the user is doing something else. 

There are two types of service 

Services come in two different flavors: 



o 



Started services 

A started service can run in the background indefinitely, even when the 
activity that started it is destroyed. If you wanted to download a large 
file from the Internet, you would probably create it as a started service. 
Once the operation is done, the service stops. 



o 



Bound services 

A bound service is bound to another component such as an activity. The 
activity can interact with it, send requests, and get results. A bound 
service runs as long as components are bound to it. When components 
are no longer bound to it, the service is destroyed. If you wanted to 
create an odometer to measure the distance traveled by a vehicle, 
you’d probably use a bound service. This way, any activities bound to 
the service could keep asking the service for updates on the distance 
traveled. 



In this chapter, we’re going to create two services: a started 
service and a bound service. We’ll start with the started service. 
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The started service app 



We’re going to create a new project that contains an 
activity called MainActivity, and a service called 
DelayedMessageService. Whenever MainActivity calls 
DelayedMes sage Service, it will wait for 10 seconds and then 
display a piece of text. 




will use -this layout 



activity_main.xml 



The activity will pass 
iex-fc t> the service 






The sev-vite will 
display the text 
a-ftev- 1 0 seconds. 



MainActivity.java DelayedMessageService.java 



We’re going to do this in three stages: 

Display the message in the log. 

We’ll start by displaying the message in the log so that we can check 
the service works OK. We can look at the log in Android Studio. 

Display the message in a Toast. 

We’ll get the message to appear in a pop-up toast so that you don’t 
have to keep your device connected to Android Studio in order to 
see it working. 

Display the message in a Notification. 

We’ll get DelayedMessageService to use Android’s built-in 
notification service to display the message in a notification. This will 
mean that the user will be able to look at the message at a later time. 

Create the project 

We’ll start by creating the project. Create a new Android project for 
an application named “Joke” with a package name of com . hf ad . 
joke. The minimum SDK should be API 16 so that it will work 
with most devices. You’ll need a blank activity called “MainActivity” 
and a layout called “activity_main” so that your code matches ours. 

The next thing we need to do is create the service. 



o 

o 

o 
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We're going to create an IntentService 

You create a new service by extending either the Service class or the 
IntentService class. 

The Service class is the base class for creating services. It provides you 
with basic service functionality, and you’ll usually extend this class if you 
want to create a bound service. 

The IntentService class is a subclass of Service that’s designed 
to handle intents. You’ll usually extend this class if you want to create a 
started service. 

As we’re creating a started service, we’re going to add a new intent service 
to the project. To do this, go to File— >New... and select the Service option. 
When prompted, choose the option to create a new IntentService. 
Give the service a name of DelayedMes sage Service, and untick 
the option to include helper start method. This is because we’re going to 
replace the code that Android Studio generates for us. 

You implement an intent service by extending the IntentService 
class and implementing its onHandle Intent ( ) method. This method 
should contain the code you want to run when the service is called: 




This is -the Smite dlass hierav-thy- 



package com . hf ad . j oke ; 



import android . app . IntentService ; 
import android . content . Intent ; 

public class DelayedMes sage Service 



Extend the (ntentSevviee elass. 

V 

extends IntentService { 



public DelayedMes sageService () { 

super ("DelayedMes sageService") ; 

} put the tode you want the sevvite to 

vun in the onttandlelntentO method- 
@ Override ^ 

protected void onHandle Intent (Intent intent) { 
//Code to do something 

} 

} 

We’ll show you an overview of this on the next page. 



□ 

Joke 

app/src/main 

MB 



java 



MCI 



com. hfad. joke 

L|3 



DelayedMessage 

Service.java 
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The IntentService from 50,000 feet 



We’re using an IntentService to create a started service, so 
lets’s take a look at how they work. 



© 



An activity says what service it needs to call by creating an explicit intent. 

The intent specifies the service it’s intended for. 




MainActivity 



Intent 




To: DelayedMessageService 
text: "Timing!" 



© 



The intent is passed to the service. 




MainActivity 



Intent 




To: DelayedMessage 
Service 
text: "Timing!" 



orfj 

\nj 

Android 




To: DelayedMessage 
Service 
text:"Timing!" 



DelayedMessageService 



© 



The service starts and handles the intent. 

The IntentService onHandle Intent ( ) method gets called and runs in 
a separate thread. If the service is passed multiple intents, it deals with them in 
sequence, one at a time. Once the service has finished running, it stops. 




DelayedMessageService 



As you can see, a service is started in the same way that you start an 
activity: by creating an intent. The difference is that when you start 
a service, what’s on screen doesn’t change because the service has 
no user interface. 

We want DelayedMessageService to display a message in 
Android’s log. Before we update the service, let’s look at how you log 
messages. 



you are here ► 



545 



welcome to fiskidagurinn 

How to log messages 

Adding messages to a log can be a useful way of checking your code 
is working the way you want. You tell Android what to log in your 
Java code, and when the app’s running, you check the output in 
Android’s log, or logcat. 

You log messages using one of the following methods in the 
Android . util . Log class: 




Log 

Toast 

Notification 



Log.v(String tag, String message) 
Log.d(String tag, String message) 
Log.i(String tag, String message) 
Log.w(String tag, String message) 
Log.e(Stringtag, String message) 



Logs a verbose message. 

Logs a debug message. 

Logs an information message. 
Logs a warning message. 

Logs an error message. 



Each message is composed of a String tag you use to identify the 
source of the message, and the message itself. As an example, to log 
a verbose message that’s come from DelayedMessageService, 
you use the Log . v ( ) method like this: 

Log. v ("DelayedMessageService" , "This is a message"); 

You can view the logcat in Android Studio, and filter by the 
different types of message. To see the logcat, select the Android 
option at the bottom of your project screen in Android Studio and 
then select the Devices | logcat tab: 



There’s also a Log-wt-fO 
method you dan use t o report 
exceptions that should never 
happen- Awarding to the Androi d 
documentation, wt-f means 'What 
a Terrible Failure”. 1/Ve know it 
means "Welcome to Fiskidagurinn”, 
which re-fers to the ^reat 
Fish Pay -festival held annually 
in Dalvik, Iceland- Android 
Developers can o-ften be heard 
to say ”/k!y A\/D just took 8 
minutes to boot up. 1/VTF??’ 3s 
a tribute to the small town that 
gave its name to the standard 
Android executable byteCode 
-format- 



Select the Deviees|logcat tab 



You can -filter on the 
type o£ message here- 



Devices 1 logcat 




1/1 

M 




■■ Devices 


-+■ I * logcat 




-■ 


9 


No Connected Devices 










1/1 

E= 

rt 






a 




This is the logcat area- 




rt 

> 

-v 

"5 

Cell 

■S' 


» 


Nlo debuggable applications 


T 

4- 

» 




Any messages you log 
will appear here- 





^ TO D O 


6: Android H Terminal 


Event Log 0 Cradle Console |i Memory Monitor 


□ 


zu . 


1:23 LF £ UTF-S £ b ® 





Select the Android option- 
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The full RelayedMessageService code 

We want our service to get a piece of text from an intent, wait for 1 0 
seconds, then display the piece of text in the log. To do this, we’ll 
create a showText ( ) method to log the text, and then call it from the 
onHandle Intent ( ) method after a delay. 

Here’s the full code for DelayedMessageService.java (replace the code 
Android Studio has created for you with this code): 

package com . hf ad . j oke ; 



import android . app . IntentService ; 
import android . content . Intent ; 

import android. util . Log; c i ... . . . 

the IntentSevvide el ass. 

'V 

public class DelayedMessageService extends IntentService { 

Use a donstant to pass 

public static final String EXTRA_MESSAGE = "message" ; a message -(Vom the 

activity to the sewide- 

public DelayedMessageService () { 

super ("DelayedMessageService") ; Call the super donstrudtor- 

} This method Coh-b'ms -the Code you wa«t -to 

ru* whe» the servi ce receives a» mteht. ftiil 

0 Override ^ Joke 

protected void onHandlelntent (Intent intent) { 
synchronized (this) { 
try { 

VVait 1 0 seconds. 



wait (10000) ; 

} catch (InterruptedException e) { 
e . prints tackTrace ( ) ; 

* £jet the te*t -Pr om the intent 

} V 

String text = intent . gets tringExtra (EXTRA_MESSAGE) ; 
showText (text) ; 

^ ^^>-Call the showTe*tO method- 

private void showText (final String text) { 

Log. v ("DelayedMessageService" , "The message is: " + text) 

} ^ 

This logs a piede o( te*t so we da* see it in 
the logdat through Android Studio- 



43 

app/sre/main 



java 






com. hfad. joke 

L S 

DelayedMessage 

Service.java 
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Log 
Toast 

Notification 

Just like activities, services need to be declared in 
AndroidManifest.xml using the <service> element. This 
is so that Android can call the service; if a service isn’t 
declared in AndroidManifest.xml, Android can’t call it. 

Android Studio declares the service in AndroidManifest.xml 
for you automatically when you create a new service. Here’s 
what the code looks like: 



You declare cervices in AndroidManifest.xml 



<?xml version="1.0" encoding="utf-8 " ?> 

<manif est xmlns : android="http : / / schemas . android . com/ apk/ res/ android" 
package="com. hfad. joke" > 

Application 



□ 



Joke 






Activity 



</ activity> 



<service 



You declare 3 service in 
Andv-oid/Vlanitest ^l like tWis. 
Android Studio should do this 

you au'bomr^a'ticallY* 



app/src/main 

AndroidManifest.xml 



android :name=" .DelayedMessageService" 
android: exported=" false" > 

</service> scvvidc name has a . i v\ hov\t o-p 

it so that Android dan dombihc it 
with the package na*«e to derive the 
</manifest> fully gualitied class name- 



</ application> 



The <service> element contains two attributes. 

The android: name attribute tells Android 
what the name of the service is — in our case, 
DelayedMessageService. 

The android : exported attribute tells Android whether 
the service can be used by other apps. Setting it to false 
means that the service will only be used within the current 
app. 

Now that we have a service, we need to run it by getting an 
activity to call it. 
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Add a button to activitY_main.xml 



We’re going to get MainActivity to start 
DelayedMes sage Service whenever a button is clicked. 
We’ll start by adding the button to MainActivity’s layout. 

First, add the following values to strings. xml (we’ll use them in 
our activity and layout code): 



<string name="button_response M >Timing!</string> 

<string name="button_text">What is the secret of comedy ?</string> 

Next, update activity _main. xml so that MainActivity 
displays a button: 

<RelativeLayout xmlns : android="http : //schemas . android . com/ apk/ res /android" 

xmlns : tools="http: //schemas . android.com/tools" p 

android: layout_width="match_j?arent" 1 ) 




Joke 



android : layout_height="match_j?arent" 
tools : context=" .MainActivity"> 



app/src/main 




On the next page, we’ll update the code for MainActivity. java 
so that it starts the service. 



</RelativeLayout> 



<Button 



android : layout_width="wrap_content " 
android : layout_height="wrap_content 
android : text= " @ s tr ing/bu tton_tex t " 
android : id=" @+id/but ton" 
android: onClick="onClick" 
android: layout_alignParentTop="tru€ 
android : layout_centerHorizontal=" tr 
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start service 

You start a service using startServiceO 

You start a service from an activity in a similar way to how 
you start another activity You create an explicit intent that’s 
directed at the service you want to start. You then start the 
service using the startService () method: 

Intent intent = new Intent (this, DelayedMessageService . class) ; 

startService (intent) ; — - Startmj a service is iust like starts a* activity e *cept 

you use startServiceO instead o-f start/\ctivityO. 

We’ll use this in MainActivity’s onClick ( ) method so 
that the service gets started whenever its button gets clicked. 

Here’s the code: 



Log 

Toast 

Notification 



package com . hf ad . j oke ; 

import android . app . Activity ; 
import android . content . Intent ; 

import android. os. Bundle; fc yfcVe vsmg these classes, 

import android . view . View ; 

public class MainActivity extends Activity { 



□ 

Joke 

app/sre/main 

H3 



java 



m3 



com. hfad. joke 

L @ 

DelayedMessage 

Service.java 



@ Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_main) ; 

^ This will \run when -the 

\£ bu-t-bom gets clicked- Create the intent- 

public void onClick (View view) { ^ 

Intent intent = new Intent (this, DelayedMessageService . class) ; 
intent . putExtra (DelayedMessageService . EXTRA_MESSAGE , 

getResources () . getString (R. string.button_response) ) 

startService (intent) ; 

) T 

Start sev-vi u- 



* Add text -to the ihteht- 



That’s all the code we need to get our activity to start the 
service. Let’s see what happens when we run the app. 
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Test drive the app 





Log 

Toast 

Notification 



Press the button, switch back to Android Studio, and watch the 
logcat output in the lower-right corner of the IDE. After 10 
seconds, the word “Timing!” appears in the logcat. 




Now that we know the service works, let’s make it display a 
message on the screen so you don’t have to keep your device 
plugged into your computer to see it running. 
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We want to send a message to the screen 

Services don’t have user interfaces like activities do, but that 
doesn’t mean that they don’t need to keep the user informed 
about stuff that’s happening. The user might need to know 
when a file has been downloaded, for instance. 

In our case, it would be a lot neater if we could display a 
message in a toast on the screen instead of in the log. There’s 
just one thing — any code that updates the user interface needs 
to run in the main thread 



Screen updates require the main thread 

As you’ve seen, when you use an intent service, you put the code 
you want to run in the onHandle Intent ( ) method. This 
code then runs in the background in a separate thread. This is 
great for code that you want to run in the background, but not 
so great if you want to update the user interface. This is because 
you can only update the user interface in the main thread. 

To get around this, we’ll use a handler. As we said back in 
Chapter 4, a handler lets you post code that needs to be run to 
a separate thread. We can use the handler post ( ) method to 
post the code to create a toast to the main thread. The code will 
then run on the main thread and the toast will get displayed 
correctly. 



To get the code working, we need to do the following: 



o 

o 



Create a handler in the main thread. 

Use the Handler post ( ) method in the service 
onHandle Intent ( ) method to display a toast. 






Log 

Toast 

Notification 




Well jei -the sevvite -to display 
a message m a -toast 



The first thing we need to look at is how to create a handler in 
the main thread. 
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onStartCommandd runs on the main thread 

To create a handler on the main thread, we need to create a 
Handler object in a method that runs on the main thread. We 
can’t use the onHandle Intent ( ) method, as this runs in a 
background thread. Instead, we’ll use the onStartCommand ( ) 
method. 

The onStartCommand ( ) method gets called every time the 
intent service is started. The onStartCommand ( ) method runs 
on the main thread, and runs before the onHandlelntent () 
method. If we create a handler in the onStartCommand ( ) 
method, we’ll be able to use it to post code to the main thread in 
the onHandlelntent ( ) method: 



public class DelayedMessageService extends IntentService { 

private Handler handler; A<W the handler as a frfeate variable so 

dlTTCV’Ch't mCT-hods SitttSS 



This method \TUKS or\ the main thread, so it 
Creates a new handler on the main thread. 

@ Override 

public int onStartCommand (Intent intent, int flags, int startld) { 
handler = new Handler ( ) ; 

return super . onStartCommand (intent , flags, startld) ; 



> ^ 

Call the IntcntServide onStartCommandO method- 

@0verride 

protected void onHandlelntent (Intent intent) { 

//Use the handler to post code to the main thread 

} 



□ 

Joke 

Hn 

app/sre/main 

La 



} 

When you use the onStartCommand ( ) , you must call its super 
implementation using: 



java 



4::j 



com. hfad. joke 

LM 



DelayedMessage 

Service.java 



super . onStartCommand ( intent , flags, startld) 



This is so that the intent service can properly handle the life of its 
background thread. 

On the next page, we’ll show you the full code for 
DelayedMessageService.java and then look at it running. 
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DelayedMessageService code 



The full PelayedMessageServicejava code 

package com. hfad. j oke; 



import android . app . IntentService ; 
import android . content . Intent ; 

import android . os . Handler ; 
import android. widget . Toast 



Were us'm^ these extra classes. 



public class DelayedMessageService extends IntentService { 






Log 

Toast 

Notification 



public static final String EXTRA_MESSAGE = "message"; 

private Handler handler; <- Add the handler as a new private variable. 



public DelayedMessageService ( ) { 

super ( "DelayedMessageService" ) ; 



Crea- le the handler on -the r*a'm -thread- 

@ Override 

public int onS tar tCommand (Intent intent, int flags, int startld) { 
handler = new Handler ( ) ; 

return super . onS tar tCommand (intent , flags, startld) ; 



} 

Were not Changing this method. 

SOverride ^ 

protected void onHandlelntent ( Intent intent) { 
synchronized (this) { 
try { 



wait (10000 ) ; 

} catch (InterruptedException e) { 
e . printStackTrace ( ) ; 



} 

String text = intent . getStringExtra (EXTRA_MESSAGE) ; 
showText (text) ; 



□ 

Joke 

■ 

app/sre/main 

4Z3 



java 






com. hfad .joke 

LQ 



DelayedMessage 

Service.java 



private void showText ( final String text) { 



handler post (new Runnable () { p osl ^ ^ ^ ^ ^ 

@ °ve rri de thread using the handler. 

public void run() { 

Toast .makeText (getApplicationContext () , text, Toast . LENGTH_LONG) .show() 



x 

This is -the dontext you want to display -the -toast m- 
There s more about this on the next pa$e- 



554 Chapter 13 



services 



The application context 

Let’s take a closer look at the line of code that displays the toast: 

Toast . makeText (getApplicationContext () , text, Toast . LENGTH_LONG) . show ( ) ; 

The first parameter of the Toast . makeText ( ) method is the 
context in which you want the toast to appear. When you create 
a toast in an activity, you use this to pass it the instance of the 
current activity 

This doesn’t work in a service, because the service context doesn’t 
have access to the screen. Whenever you need a context in a service 
in situations like this, you must use getApplicationContext ( ) 
instead. This gives us the context for whatever app happens to be in 
the foreground when the code is run. It means that the service will 
be able to make a toast appear, even if we’ve switched to a different 
app. 



vZ 

0 



Log 

Toast 

Notification 




Test drive the app 

Let’s try running our app again. 

When you click on the button in MainActivity, 
a toast appears after 1 0 seconds. The toast appears 
irrespective of which app has the focus. 

If you click on the button multiple times in quick 
succession, multiple toasts appear about 1 0 seconds 
apart. The service deals with each intent it receives, 
one at a time. 
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Can we improve on using Toasts? 

We now know how to send a piece of text to the screen using 
a toast. That’s useful if we want to tell the user that, say, the 
very long download of a file has completed. But the truth 
is toasts don’t really stand out that much, and if you’re not 
looking at the screen at exactly the right moment, you don’t 
even see them. If we really want to keep the user informed 
about important stuff, we need to replace our toast with a 
notification. 

Notifications are messages that appear in a list at the top of 
the screen. If the user doesn’t happen to see the notification 
at the time it was created, it doesn’t matter. She can still see 
them by dragging her finger down from the top of the screen 
to open the navigation drawer. 




Log 

Toast 

Notification 




for controlling location updates). 

You use the notification service to manage notifications. We’ll 
give you an overview of how it will fit in with the app on the 
next page. 
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How you use the notification service 

Here’s an overview of how our app will work with the Android 
notification service: 



© 



MainActivity starts DelayedMessageService by passing it an intent. 




MainAc+ivi+y 



DelayedMessageService 



o 



DelayedMessageService creates a new Notification object. 

The Notification object contains details of how the notification should be 
configured, such as its text, title, and icon. 





text = "Timing!" 



DelayedMessageService Notification 



© 



DelayedMessageService creates a Notif icationManager object to 
access Androids notification service. 

DelayedMessageService passes the Notification object to the 
Notif icationManager, and the notification gets displayed. 




We’ll start by creating the notification. 
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build a notification 

Log 
Toast 

Notification 

notification builder 

You create a notification using a notification builder to create a 
new Notification object. The notification builder allows 
you to create a notification with a specific set of features, without 
writing too much code. Each notification must include a small 
icon, a title, and some text. 

Here’s an example of the code you use to create a notification. 

It displays a high priority notification that vibrates when the 
notification appears and disappears once it’s clicked: 



You create notifications using a 



vZ 

0 



This displays a Notification notification = new Notification. Builder (this) 
sn»all no'ti-Tiia'tion. setSmalllcon (R.mipmap . ic_launcher) 

i£o» in -this Case, . setContentTitle (getString (R. string. app name) ) ^/Sel "the tille 3nd 

the miprnap called ~ 

iejaundhet. . setContentText (text) < 

. setAutoCancel (true) •^—''Wake the notiridation disappear when clicked- 



. setPriority (Notification. PRIORITY_MAX) ^ £j ive ,t a maximum priority and 

. setDefaults (Notification. DEFAULT_VIBRATE) Z se -fc it bo vibrate to jet 3 larje 
. build () ; "heads up" notification. 



These are just some of the properties that you can set. You can 
also set things like visibility to control whether the notification will 
appear on the lock-screen, a number to display a count next to 
the notification in case you want to send many notifications from 
the same app, and a sound to make the notification make a noise. 
You can find out more about these properties here: 

https:/ / developer, android, com/ reference/ android/ app/ 
Notification. Builder, html 

It’s also a good idea to say which activity should be displayed 
when the user clicks on the notification. In our case, for instance, 
we can get Android to display MainActivity when the 
notification is clicked. We ’ll show you how to do this on the next 
page. 




Watch it! 



level 16 



Some of 
the 

notification 
properties 
require API 
or above. 



If you need to support 
older devices, you won’t 
be able to use all of the 
properties. 
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fretting your notification to start an activity 

You get a notification to start an activity when it’s clicked using a 
pending intent. A pending intent is an intent an app can pass to 
other applications so that they can submit the intent on your app’s 
behalf at a later time. 

Here are the steps you go through to create the pending intent: 

1. Create an explicit intent 



First, you create a simple explicit intent directed to the activity you 
want to start when the notification is clicked. In our case, we’ll start 
MainActivity: 



This is a normal 
■that starts /VlainAfitWity- 

A 

Intent intent = new Intent (this, MainActivity . class) ; 



Intent 




To: MainActivity 



DelayedMessageService 

t. Pass the intent to the TaskStackBuilder 

Next, we use a TaskStackBuilder to make sure that the 
back button will play nicely when the activity gets started. The 
TaskStackBuilder allows you to access the history of activities 

used by the back button. We need to get the back stack related to the Qrtdfa t a TaskS-tadkBuildev 

activity, and then add the intent we just created to it: 






TaskStackBuilder stackBuilder = TaskStackBuilder . create (this) ; 



stackBuilder . addParentStack (MainActivity . class) ; 

These lines make the back button work 

properly when the activity is started- 



stackBuilder . addNextlntent (intent) ; 



Here's an intent for 
MainActivity. Can you 
add it to MainActivity's 
back stack? 



O' 



Intent 



To: MainActivity 




DelayedMessageService 

The story continues on the next page. 



TaskStackBuilder 
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getPendinglntentQ 



vZ 

0 



5. G-et the pending intent from the TaskStack&uilder 

Next, we get the pending intent from the TaskStackBuilder using 
its getPendinglntent ( ) method. The getPendinglntent ( ) 
method takes two int parameters, a request code that can be used to 
identify the intent, and a flag that specifies the pending intent’s behavior. 



Log 

Toast 

Notification 



Here are the different flag options: 

FLAG_CANCEL_CURRENT 

FLAG_NO_CREATE 

FLAG_ONE_SHOT 

FLAG_UPDATE_CURRENT 



If a matching pending intent already exists, cancel it before 
generating a new one. 

If a matching pending intent doesn't already exist, don't 
create one and return null. 

The pending intent can only be used once. 

If a matching pending intent already exists, keep it and 
replace its extra data with the contents of the new intent. 



In our case, we’ll use FLAG_UPDATE_GURRENT to modify any 
existing pending intent. Here’s the code: 

This tveaies -the '"-tent 

Pendinglntent pendinglntent = 

s tackBuilder . getPendinglntent ( 0 , Pendinglntent . FLAG_UPDATE_CURRENT) ; 
Pendinglntent 

s — 





To: MainActivity 

DelayedMessageService TaskStackBuilder 

4. Add the intent to the notification 

Finally, you add the pending intent to the notification using the 

setContentlntent ( ) method: ,, , . . . r 

m<X the pending intent to the noti+i £ati 

notification. setContentlntent (pendinglntent) ; ^-thai AlainActiviiy starts when it's clicked 

Pendinglntent 



To: MainActivity 



ion so 





DelayedMessageService 

Once you’ve given the notification a pending intent telling it which 
activity to start when it’s clicked, all that’s left is to display it. 



Notification 
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Send the notification using the 
notification service 



So far we’ve looked at how to create and configure a notification. 
The next thing is to pass it to the Android notification service so 
that it appears on the device. 

You access Android’s built-in services using the 
getSystemService ( ) method. It takes one argument, the 
name of the service you want to use. 



In our case, we want to use the notification service, so we use 
code like this: 



This is an IP 'well w* tor the notitidaW 

I ^ 



public static final int NOTIFICATION_ID = 5453; 
NotificationManager notificationManager = 



This is how you access /Udroid's 
no-ti-Picaiio* service. 



(NotificationManager) getSystemService (Context .NOTIFICATION_SERVICE) ; 



notificationManager . notify (NOTIFICATION_ID , 

The NOT I FI CAT 1 0N_ ID is used to identify the notification. If 
we send another notification with the same ID, it will replace 
the current notification. This is useful if you want to update an 
existing notification with new information. 



notification) ; 






Use -the no-titidatior. servide -to 
display "the r.o'titida'tion we dreated 



The notification service deals with all of the issues involved in a 
background service sending updates to the screen. This means 
that you no longer need to use a handler in order to update the 
user interface; the notification service handles it for you. 



On the next page, we’ll show you the updated code for 
DelayedMessageService. 



-there-, ase no 

Dumb Questions 



n Why do I need to include an icon in a 
notification? 



n What happens if I don’t set the priority and 
switch vibrate on? 



The notification system needs an icon to display the 
notification at the very top of the screen. 



The notification will still be sent, but it won’t pop up 
on your screen. You’ll still see it listed in the navigation 
drawer. 
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DelayedMessageService code 



Log 
Toast 

Notification 

Here’s the full code for DelayedMessageService.java. It now 
uses a notification instead of a toast to display a message: 



The full code for PelayedMe$sageService.java 



vZ 

0 



package com. hfad. j oke; 

import android. app . IntentService; 

import android . app . Notification ; 
import android . app . Notif icationManager ; 
import android . app . Pendinglntent ; 
import android . app . Tasks tackBuilder ; 
import android . content . Context ; 
import android . content . Intent ; 

^ 14/ > I 

We ** h0 ' OKl 9 e ' r displaying a Toas-t, 

so « iWt «td ttei iifoUs. 



□ 

Joke 

4sa 

app/src/main 

Ha 



WeVe wsm3 -these extra classes. java 



413 



com. hfad .joke 

Li" 



DelayedMessage 

Service.java 



public class DelayedMessageService extends IntentService { 



public static final String EXTRA_MESSAGE = "message"; 

l/Ve no longer need a Handler. 



public static final int NOTIFICATION_ID = 5453; 

V 

public DelayedMessageService () { This is used “to identify the 

wrt+if’iea+ion. It tould be any number, 

super ( "DelayedMessageService" ) ; notHr cat ^ </uc:*2 ' 

we just deeded on 



l^/erc not changing this method- 

@Override 

protected void onHandlelntent (Intent intent) { 
synchronized (this) { 
try { 



wait ( 10000 ) ; 

} catch ( InterruptedException e) { 
e . printStackTrace ( ) ; 



} 



String text = intent . getStringExtra (EXTRA_MESSAGE ) ; 
showText (text) ; 
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The PelayedMessageService.java code (continued) 

1 1 1 m i 1 . rT i ■^X<rrf7vPrT?»-i<f1^ 3DJ fer — 

, , , 

f A/cVc no longer us mg 

a Handler, so we don -t 
need -this method- 



private void showText (final String text) { 



^ elre 1,10 ' 0h 9 eir displaying the message using a Toast- 

C^a^Osm^^ , 5^ftr > (^ r t^prpTica^T5nl3Qja^^^j^^ 

>4^. Cveate an intent- 

Intent intent = new Intent (this, MainActivity . class) ; 

Tasks tackBuilder stackBuilder = Tasks tackBuilder . create (this) ; 
stackBuilder . addParentS tack (MainActivity . class) ; Use a TaskSta^kBuilder to make 
stackBuilder . addNextlntent (intent) ; ^^~the baek button play nidely and 

Pendinglntent pendinglntent = Create the pending in-tent 

stackBuilder . getPendinglntent ( 0 , Pendinglntent . FLAG_UPDATE_CURRENT 

) ; 



Notification notification = new Notification .Builder (this) 

. setSmalllcon (R . mipmap . ic_launcher ) 

. setContentTitle (getString (R. string. app_name) ) 

. setAutoCancel (true) r - , . ,, , . p.. 

> Build -the noii-Vidation- 

. setPriority (Notification . PRIORITY_MAX) 

. setDefaults (Notification. DEFAULT_VIBRATE) 

. setContentlntent (pendinglntent) 

. setContentText ( text) 

. build () ; 

NotificationManager notificationManager = 

(NotificationManager) getSystemService (Context .NOTIFICATION_SERVICE) ; 
notificationManager . notify (NOTIFICATION_ID , notification) ; 

/r 

Display the noti-rieation using -tbe Android notitieation service. 



That’s all the code we need for our started service. Let’s go 
through what happens when the code runs. 
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What happens when you run the code 



Before you see the app up and running, let’s go through what 
happens when the code runs: 



o 



MainActivity starts DelayedMessageService by passing it an intent. 

The intent contains the message MainActivity wants 
DelayedMessageService to display 




MainActivity DelayedMessageService 



o 



DelayedMessageService waits for 10 seconds. 




DelayedMessageService 



O 



DelayedMessageService creates an intent for MainActivity. 




DelayedMessageService 



O 



DelayedMessageService creates a TaskStackBuilder and asks it to 
add the intent to Main Activity's back stack. 




DelayedMessageService TaskStackBuilder 
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The story continues 



© The TaskStackBuilder use the intent to create a pending intent and 
passes it to DelayedMessageService. 

P endinqlnte nt 
To: MainActivity 

DelayedMessageService TaskStackBuilder 





o 



DelayedMessageService creates a Notification object, sets details 
of how it should be configured, and passes it the pending intent. 



o- 



P endinqlnte nt 



To: MainActivity 
DelayedMessageService Notification 



o 



text= "Timing!" 



© 



DelayedMessageService creates a NotificationManager object to 
access Androids notification service and passes it the Notification. 

The notification service displays the notification. 




Pendinqlntent 




To: MainActivity 
text= "Timing!" 



DelayedMessageService 



NotificationManager Notification 




When the user clicks on the Notification, the Notification uses its 
pending intent to start MainActivity. 




Notification MainActivity 



Let’s take the app for a test drive. 
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Test drive the app 

When you click on the button in MainActivity, a 
notification is displayed after 1 0 seconds. You’ll receive the 
notification irrespective of which app you’re in. 



0 


Log 


0 


Toast 


0 


Notification 



WHAT IS THE SECRET OF COMEDY? 



r 

Click Oh "the buttoh. 



A-Ct er a delay, the notification appears. 
0r\ older dentes, you mi^ht need to open 
the notification drawer to see it- 

f 



£ , 


DEIS 

H WEATHER 


□DS 

MEDIA 


n 


' mL 




PLAYER 




at 

RunKeeper 


BBCJ/eather 


BBC Media.. 


Headspace 


X 




m 


(9 


MyFitnessPal 


Any.do 


Keep 


ZazenMedit.. 



When you click on the notification, Android returns you to 
MainActivity. 



Clidkihg oh the hoti-pidatioh starts 
MainActivity, just as we wanted- 




So far you’ve seen how to create a started service that displays 
a notification using the Android notification service. After an 
exercise, we’ll look at how you create a bound service. 
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Service Magnets 



Below you'll see most of the code needed to create a started service 
called WombleService that plays a .mp3 file in the background, 
and an activity that uses it. See if you can finish off the code 



^TWis is the service. 



public class WombleService extends 



public WombleService ( ) { 

super ( "WombleService" ) ; 

} 



QOverride 

protected void (Intent intent) { 

MediaPlayer mediaPlayer = 

MediaPlayer . create (getApplicationContext ( ) , R. raw . wombling_song) ; 
mediaPlayer . start () ; 

, — This uses -the Androi d MediaPlayer class to play a -Pile called 

won^ling L _son<)..»,p3. The -Pile is located in the res/raw Polder. 



This is the activity- 

public class MainActivity extends Activity { 

@Override 

protected void onCreate (Bundle savedlnstanceState ) { 

super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_main) ; 

} 



public void onClick(View view) { 

Intent intent = new Intent (this. 



) ; 



(intent) ; 



WombleService . class 



IntentService 
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Service Magnets Solution 



Below you'll see most of the code needed to create a started service 
called WombleService that plays a .mp3 file in the background, 
and an activity that uses it. See if you can finish off the code. 

I ; 1 /£ This is the sevvide- It e*tends 

public class WombleService extends | IntentServic^ ^J ( the IntentSevvide dlass. 



public WombleService ( ) { 

super ( "WombleService" ) ; 



QOverride 



The dode needs to tun in the 
onttandlelntentO method- 



onHandlelntent 



(Intent intent) { 



protected void ^L, 

MediaPlayer mediaPlayer 

MediaPlayer . create (getApplicationContext ( ) , R. raw . wombling_song) 
mediaPlayer . start ( ) ; 



^-This is the adtWity- 

public class MainActivity extends Activity { 



@Override 

protected void onCreate (Bundle savedlnstanceState ) { 

super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_main) ; 



public void onClick(View view) { 

Intent intent = new Intent (thi 



is, C 






Create d» explicit intent 
di retted at 1 /VornbleServieedass. 



WombleService . class 



] 



) ; 



startService 

Start the service. 



(intent) ; 



^/ou didn't need to 
use these magnets. 
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Pound services are more interactive 



As we said earlier, a started service runs in the background indefinitely, 
even when the activity that started it is destroyed. Once the operation 
is done, the service stops itself. 

A bound service is bound to another component such as an activity. 
The activity can interact with it, send requests, and get results. To 
see this in action, we’re going to create a new app that uses a bound 
service that will work like an odometer to track the distance traveled 
by a vehicle. 

How the odometer app will work 

We’re going to create a new project with an activity called 
MainActivity, and a service called OdometerService. 
MainActivity will use OdometerService to get the distance 
traveled. 



© 



MainActivity binds to OdometerService. 

MainActivity uses the OdometerService getMiles ( ) 
method to ask for the number of miles traveled. 



e 



The OdometerService uses the Android location services to 
keep track of when the device moves. 

It uses these locations to calculate how far the device has traveled. 



© 



The OdometerService returns the distance traveled to 
MainActivity. 

MainActivity displays the distance traveled to the user. 





We’ll start by creating the service. Let’s see what we need to do. 



This is built-*** 

-to Android- Our 
OdometerService will 
use it to listen -for 
Changes in location- 




Android 

Location 

Service 
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The steps needed to create the OdometerService 

There are a few steps we need to go through in order to 
create the OdometerService: 



© 



Define an Odometer Binder. 

A Binder object allows activities to bind to services. We’ll define a 
subclass of Binder called OdometerBinder that will enable our 
activity to connect to the OdometerService. 




OdometerBinder 



o 



Create a LocationListener and register it with Androids 
location service. 

This will allow the OdometerService to listen for changes in the 
device location and work out the distance traveled in meters. 





Location 

Service 



o 



Create a public getMiles() method. 

The activity will be able to use this to get the number of miles traveled. 



getMilesQ 




MainActivity OdometerService 




Binder 

Location 

getMilesQ 



We’ll start by creating a new project for our Odometer app. 
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Create a new Odometer project 

Create a new Android project for an application named “Odometer” 
with a package name of com . hf ad . odometer. The minimum 
SDK should be API 16 so that it will work with most devices. You’ll 
need a blank activity called “MainActivity” and a layout called 
“activity_main” so that your code matches ours. 

We’re going to add a new service to the project. This time we’re 
going to use a service that extends the Service class and not the 
IntentService class. This is because the IntentService class 
is intended for services that handle intents, as we did in the previous 
example. In this case, we’re going to start the service by binding to it 
so there’s no advantage in using the IntentService class. 

You add a service that extends the Service class in a similar way 
to how we added a service earlier. Go to File— »New... and select 
the Service option. When prompted, choose the option to create a 
new Service (not an IntentService), and give the service a name of 
“OdometerService”. Untick the “exported” option as this only needs 
to be true if you want services outside this app to access the service. 
Make sure that the “enabled” option is ticked; if it isn’t, the activity 
won’t be able to run the app. 

Here’s what the code looks like to create a bound service based on 
the Service class: 




t 

ttev-e's -the dlass hiev-av-dhy 
■for the Sev-vite dlass. 



package com . hf ad . odometer ; 

import android . app . Service ; 
import android . content . Intent ; 
import android . os . IBinder ; 



□ 



Odometer 



4 



The tlass extends -the Sew \ct dass. 



app/src/main 

HU 



public class OdometerService extends Service { 

^^-The cmBihdO method is used *C ov- 

QOverride binding Components to the sewiCe- 

public IBinder onBind (Intent intent) { 

//Code to bind the service 

} 



java 

4 

com. hfad. odometer 



LQ 

J.od< 

l_il 



Odometer 

Service.java 



The onBind ( ) method is used to bind the service to an activity. 
We’ll look at how binding works on the next page. 
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How binding works 

This is how an activity binds to a bound service: 

© 



The activity creates a ServiceConnection object. 

A ServiceConnection is used to form a connection with the service. 




MainActivity 



ServiceConnection 



Binder 

Location 

getMilesQ 



The activity passes an Intent down the connection to the service. 

The intent contains any additional information the activity needs to pass to the 
service. 

In tent ^ \ 

MainActivity ServiceConnection OdometerService 




The bound service creates a Binder object. 

The Binder contains a reference to the bound service. The service sends the Binder 
back along the connection. 




MainActivity 



ServiceConnection 



OdometerService 



When the activity receives the Binder, it takes out the Service 
object and starts to use the service directly. 




MainActivity 

To allow the activity to bind to the service, we need to get 
the service to create the Binder object, and pass it to the 
activity using its onBind ( ) method. 



OdometerService 
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Pefine the Binder 



When an activity asks to bind to a service using a service connection, 
the connection calls the onBind ( ) method of the service. The 
onBind ( ) method returns a Binder back to the connection. This 
is then passed back to the activity. 

When you create a bound service, you need to define the Binder 
yourself. We’re going to define a Binder called OdometerBinder 
by declaring it as an inner class like this: — 



public class OdometerBinder extends Binder { 
OdometerService getOdometer () { 

return OdometerService . this ; 



When you dreate a bound servide, you 
need -bo provide a Binder implementation. 



} 



The adtivity will use this method to get 
B V'CTCV'Chdc the 0dorwe‘te\r£ev'vi£e. 



} 



We’ll then return an instance of the OdometerBinder in the 
service onBind ( ) method: 



□ 

Odometer 

4H 

app/src/main 
java 

LQ 

com. hfad. odometer 

OdometerService getOdometer () { _ , , ^ 

V. The Binder implementation. LJ 



import android. os. Binder; ^ ^ ^ t | asses . 

import android . os . IBinder ; 

public class OdometerService extends Service { 

private final IBinder binder = new OdometerBinder () 



public class OdometerBinder extends Binder { 
neterService getOdometer () { 

return OdometerService . this ; 



} 



Odometer 

Service.java 



} 



} 



@ Override 

public IBinder onBind (Intent intent) 
return binder; 

} 



^The onBindO method returns (Binder. This is 
an inter bade the Binder dlass implements. 



When the activity binds to the service with a service connection, 
the connection will call the onBind ( ) method, which will 
return the OdometerBinder object. When the activity receives < 
the OdometerBinder from the connection, it will use the 
getOdometer ( ) method to get the OdometerService object. 



-You’ll see this in adtion when we 
dreate an adtivity that uses the 

sev-vifce. 
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fret the service to do something 

The next thing we need to is get our service to do something. We 
want our service to be able to tell the activity how far the device 
has traveled. There are two things we need to do to enable this: 




Binder 

Location 

getMiles() 



O 



Set up a listener when the service gets created that 
will listen for changes in the device location. 





OdometerService 



LocationListener 



O 



Return the number of miles traveled to the activity 
whenever the activity asks for it. 




MainActivi+y 



OdometerService 



Let’s start by looking at what methods are available in the 
Service class that might be useful to us. 
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The Service class has four key methods 

We’re creating a bound service that extends the Service class. The 
Service class has four key methods that you might want to use: 



Method 


When it’s called 


What you use it for 


onCreate O 


When the service is first 
created 


One-time setup procedures, 
such as instantiation 


onStartCommand Q 


When an activity starts 
the service using the 

startService ( ) 

method 


You don't need to implement 
this method if your service 
isn't a started service; it will 
only run if the service is started 
using startService () 


onBindQ 


When an activity wants to 
bind to the service 


You must always implement 
this method by returning an 
IBinder object; if you don't 
want activities to bind to the 
service, return null instead 


onDestroyO 


When the service is no 
longer being used and is 


Use this method to clean up 
any resources 



about to be destroyed 



In our case, we want to start getting location updates when the 
service is created. As this is a one-time setup, we’ll do this in the 
onCreate ( ) method: 

©Override js ^ £ e(rV ice onCVeat eO method looks like- 

public void onCreate () { ^ 

//Code to set up the listener 

} 

On the next page, we’ll look at how we can get location updates. 
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Location, location, location... 

If you want to find out the location of your device, you use the 
Android location service. The location service uses information from 
the GPS system and the names and strengths of nearby WiFi networks 
to find your location on the surface of the Earth. 




Binder 

Location 

getMilesQ 



You start by creating a LocationListener. A location listener is 
used for getting updates on when the device location has changed. 

You create the location listener like this: 

LocationListener listener = new LocationListener ( ) { 

@ Override 



.This is the new LocationListener. 

\h 



public void onLocationChanged (Location location) { 

//Code to keep track of the distance 

} This method yts Called whenever the LocationListener is told the device 

lodation has dhanged- The Lotabon parameter desdribes the durrent lodatior. 

©Override 



public void onProviderDisabled (String argO) {} 



©Override 



©Override 




} ; 



To keep track of distances in location, you need to override the 
LocationListener onLocationChanged ( ) method. 

This method has one parameter, a Location object that 
represents the device current location. 

You can find the distance in meters between two locations using 
the Location distanceTo ( ) method. As an example, if you 
use a Location object called lastLocation to record the 
device’s last location, you can find the distance in meters between 
the locations using: 

double distancelnMeters = location . distanceTo (lastLocation) ; 

We’ll show you the full code for the listener on the next page. 
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Add the LocationListener to the service 

Here’s the revised code for Odometer Service.] av a (the onCreate () 
method includes a location listener that keeps track of the distance the 
device has traveled): 



public class OdometerService extends Service { 

private static double distancelnMeters; 

private static Location lastLocation = null; 

* 

WeVe storin<) -the distance traveled in meters and 
■the last location as static private variables. 



□ 



Odometer 



Ha 

app/src/main 

Ma 

java 



- Create ihc listener. 



H ■ 

com. hfad. odometer 

L @ 

Odometer 

Service.java 



@ Override 

public void onCreate () { sT 

LocationListener listener = new LocationListener () { 

@ Override 

public void onLocationChanged (Location location) { 

if (lastLocation == null) { |-p it's out -first location, set lastLocation to 

lastLocation = location; "tbe Current Location- 



} 



distancelnMeters += location . distanceTo (lastLocation); 



lastLocation = location; 



} 



Add the distance between this location and the 
last to the distancelnMeters variable, and set 
lastLocation to the Current Location- 



@ Override 

public void onProviderDisabled (String argO) {} 



V, 



@ Override ^ . 

I Nt need to override these 
public void onProviderEnabled (String argO) {} C me thods, as they're part o-P 

yr the LocationListener inter-Pace- 

@ Override 

public void onStatusChanged (String argO t int argl , Bundle bundle) {} 



} ; 



Now that we’ve created a listener, we need to register it with the location 
service. 
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Registering the LocationListener 

You register the location listener with the Android location service 
using a LocationManager object. A location manager gives you 
access to the location service, and you create one like this: 

LocationManager locManager = (LocationManager) getSystemService (Context . LOCATION_SERVICE) ; 

The getSystemService ( ) method returns a reference to 
a system level service. In this case, we want to use Android’s 
location service, so we use: 

getSystemService (Context . LOCAT I ON_SERVICE) ; 



We used -the getSystemSev-videO 
method eavliev to get addess to 
Android’s hoti-Pidatioh servide- 



v/ 



Binder 

Location 

getMiles() 



This is how you addess the 



Once you have a location manager, you can use its 
requestLocationUpdates ( ) method to register the 
location listener with the location service, and specify criteria 
for how often you want the listener to get updated. The 
requestLocationUpdates ( ) method takes four parameters: a 
GPS provider, the minimum time interval between location updates 
in milliseconds, the minimum distance between location updates in 
meters, and a LocationListener. 



Here’s how you’d use the method to get updates every second when 
the device has moved more than a meter: 



This is -the $PS provider. 

HT 



locManager . requestLocationUpdates (LocationManager . GPS_PROVIDER , 

1000 , ^ The time in milliseconds. 



The distance in meters. - — ^ 1 r 

listener) ; 



is the LocationListener we created. 



We can use this in the Service onCreate () method to register 
the listener we created with the location service and make sure it gets 
regular updates. Here’s the code: 

Wc want to set up the listener and register it with 
the location service when the service is Created- 

LocationListener listener = new LocationListener () {...}; 

LocationManager locManager = (LocationManager) getSystemService (Context . LOCAT ION_SERVICE) 
locManager .requestLocationUpdates (LocationManager. GPS_PROVIDER , 1000 , 1, listener); 

} 



@Override 

public void onCreate () { 






That’s everything we need to register the listener with the location 
service and get it to keep track of the distance traveled. Next, we need 
to get it to report back to the activity. 
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Tell the activity the distance traveled 

If you remember, there were two things we needed our service to 
do. 

The first thing we needed was to get it to keep track of the 
distance traveled by the device. We’ve now done this by creating a 
location listener and registering it with the location service. 

The second thing we need is to get the service to tell the activity 
how far the device has traveled so that it can tell the user. To do 
this, we’ll create a simple getMiles ( ) method in the service 
that converts the current distance traveled into miles. The activity 
will call this method whenever it want to know the distance. 



getMilesQ 




The number o£ miles -traveled 



Here’s what the getMiles ( ) method looks like: 



public double getMiles () { 

return this . distancelnMeters / 1609.344; 

} 

The method takes the current distance traveled in meters, then 
divides it by 1609.344 to get the distance traveled in miles. 



^This tonver-ts -the dis*tande -traveled in 
me-ters in-to miles. Wc fcould make "this 
calculation more precise it we wanted to, 
but it's accurate enough tor our purposes. 



That’s everything we need for our OdometerService.java code. Weil 
show you the full code on the next page. 
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The full OdometerServiceJava code 

Here’s the full code for our bound service OdometerServiceJava : 



v/ 

v/ 



Binder 

Location 

getMiles() 



package com. hf ad. odometer; 

import android. app . Service; 
import android. content . Context; 
import android. content . Intent; 
import android . location . Location; 
import android. location . LocationListener ; 
import android. location . LocationManager ; 
import android. os . Binder ; M 

import android, os . Bundle; all the classes we re usm<y 

import android . os . IBinder; 



□ 

Odometer 

4a 

app/sre/main 

HU 

java_ 

4U 

com. hfad. odometer 

LQ 



Odometer 

Service.java 



public class OdometerService extends Service { 



private final IBinder binder 
private static double distancelnMeters ; 



new OdometerBinder ( ) ; 

a; 



private static Location lastLocation = null; 



^^These **£ the private variables 



we re 



usmj. 



public class OdometerBinder extends Binder { 

OdometerService getOdometer ( ) { trtzit Z bound service, you have 

return OdometerService . this ; -to de-fine a Binder object It enables the 

} activity to bind to the service. 



QOverride 

public IBinder onBind ( Intent intent) { 
return binder; 



This jets called when the activity binds to the service. 
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The OdometerServiceJava code (continued) 

@ Override Set »? 

when the sev-vide »s treated- 

public void onCreate() { ^ 

LocationListener listener = new LocationListener ( ) { 

@ Override 

public void onLocationChanged (Location location) { 
if (lastLocation == null) { 
lastLocation = location; 

} 



□ 

Odometer 

4U 

app/sre/main 

L a 

java rt 

com. hfad. odometer 

l_£ 



distancelnMeters += location . distanceTo (lastLocation) ; 
lastLocation = location; 



Odometer 

Service.java 



This is oum implemehtdtoh 
o-f the lodatio* listener. 



@ Override 

public void onProviderDisabled (String argO) {] 
@ Override 

public void onProviderEnabled (String argO) {} 



@ Override 

public void onStatusChanged (String argO, int argl, Bundle bundle) {} 

}; 

LocationManager locManager = (LocationManager) getSystemService (Context . LOCATION_SERVICE) , 
locManager . requestLocationUpdates (LocationManager . GPS_PROVIDER, 1000, 1, listener); 




to miles a*d v-etuirn it- 

public double getMiles() { 

return this . distancelnMeters / 1609.344; 



Com vert -the distance traveled Vw Register the location listener 



v/ith the location sev-vide- 



} 

The code allows an activity to bind to it, and when asked, it tells 
the activity how far the device has traveled. There’s one more 
thing we need to do with our service; we need to give the app 
permission to use the GPS. 
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declare service 



Update AndroidManife$t.xml 




Binder 

Location 

getMilesQ 



When you create an app, Android allows you to perform most actions 
by default. But there are some actions that Android needs the user to 
give permission for in order for them to work correctly. One of these 
actions is using the device GPS. If your app needs to use the device 
GPS, the user needs to give permission when the app is installed. 



Cmanifest ... > 

<uses-permission android: name= M android. permission . ACCESS_FINE_LOCATION" /> 

</manifest> 

If you don’t include this permission in AndroidManifestxml, the app will 
crash. 

You also need to check that Android Studio has added your service to 
AndroidManifest. xml : 

Cmanifest ... > 



Cuses -permission android : name=" android . permission . ACCESS_FINE_LOCATION" / > 
Capplication A 

. . . > L«J 



You tell Android that your app needs permission to use the GPS using 
the <uses-permission> element like this: 




Odometer 



Cactivity 




app/src/main 





All services need to be declared in 
AndroidMani-fest-Xml- 




AndroidManifestxml 



Cservice 



android: name=" . OdometerService" 
android: exported= M false" ^ — WieVe sett'nrv 
android : enabled=" true " > Ibis app will 



q-. - iVe’re setting this to -false, as only 
-this app will use the service- 



</service> 

</ application> 
</manifest> 



The android^enabled attribute must either be set 
to true or omitted Completely- l-f you set it to 





Let’s revisit where we’ve got to with our app after an exercise. 
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Service Magnets 

See if you can complete the code below to create a bound service 
called NumberService that returns a random number when its 
getNumber() method is called: 



public class NumberService extends Service { 

private final IBinder binder = new NumberBinder ( ) ; 
private final Random random = new Random () ; 

public class extends Binder { 

getNumberService ( ) { 

return NumberService . this ; 

} 

} 

@Override 

public (Intent intent) { 



public int getNumber() { 

return random. nextlnt ( 100 ) ; 

. ^ 



This Lo&t generates a random number. 
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Service Magnets Solution 

See if you can complete the code below to create a bound service 
called NumberService that returns a random number when its 
getNumber() method is called. 



public class NumberService extends Service { 



private final IBinder binder = new NumberBinder ( ) ; 
private final Random random = new Random (); 



public class 




extends Binder { 






Detme a N unr\ berBinder tlass 
-that extends B mder. 



. getNumberService () { ^ — The activity needs -to 



return NumberService . this ; 



@Override 



public 



Override the onBindO method so the 
adtivity dan bind to the servide. 

\|r 



get a re-Perende -to the 
A/umberServide -Prom the 
Binder, so it needs to return 
a WumberServide objedt- 




(Intent intent) { 

/ <h"The onBmdO method should return the Bidder. 



public int getNumber() { 

return random . nextint (100); 
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Where we've got to 

Let’s look again at what we want our app to do so we can see 
what’s left: 



© 



MainActivity binds to OdometerService. 

MainActivity uses the OdometerService getMiles ( ) 
method to ask for the number of miles traveled. 



Q The OdometerService uses the Android location services to 
keep track of when the device moves. 

It uses these locations to calculate how far the device has traveled. 



o 



The OdometerService returns the distance traveled to 
MainActivity. 

MainActivity displays the distance traveled to the user. 




So far we’ve created the OdometerService. It uses the 
Android location services to track locations, and uses this to 
calculate the distance traveled. 

The next thing we need to do is create MainActivity. We 
need to get it to bind to OdometerService, and then use 
the OdometerService getMiles ( ) method to display the 
distance the device has traveled. 
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Update MainActivity's layout 

We need to get MainActivity to use the service to display 
the number of miles traveled, so we’ll start by updating the 
layout file activity _main. xml. We’ll add a text view to the layout 
that we can use to display the mileage. We’ll update the text 
view every second in our Java code. 

Here’s the code for activity _main.xml\ 



Bind to Service 
Display miles 

7 

These are the things we 
need to do to /Warn Activity. 




<RelativeLayout xmlns : android= M http : //schemas . android . com/apk/res/android" 
xmlns : tool s=" http : //schemas . android . com/ tools" 
android : layout_width="match_parent" 
android : layout_height="match_j?arent " 



□ 



Odometer 



tools : context=" .MainActivity"> 



Hu 

app/sre/main 

4T) 



<TextView android : text=" " 

android : id= " @ +id/di s tance " 

android: textAppearance="? android: attr/textAppearanceLarge" 
android : layout_width="match_j?arent" 
android : layout_height="match_j?arent " 




activity_ 

main.xml 



android : layou t_cen terHor i zon tal= " true " 
android: singleLine=" false" 
android : textSize=" 60dp" /> 

</RelativeLayout> Wit’ll use the Te*t\Ae>w 

■bo display the distaste 



Next, we need to update the activity code so that it binds to 
the service and updates the text view. We already know how 
to update views, but what we don’t know is how to bind to the 
service. Let’s see how it’s done. 



9 Va u 16:16 



0.00 miles 
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Create a ServiceConnection 



Earlier on in the chapter, we said that an activity binds to a service 
using a ServiceConnection object. A ServiceConnection 
is an interface with two methods: onServiceConnected ( ) and 
onServiceDisconnected ( ) . 

The onServiceConnected () method is called when a connection 
to the service has been established and a Binder object is received 
from the service. You can use the binder to get a reference to the service. 

The onServiceDisconnected ( ) method is used when the 
connection to the service has been lost. 



Ct'O'-’O 

Main Service Odometer 

Activity Connection Service 



When you need an activity to bind to a service, you need to create your 
own implementation of the ServiceConnection. Here’s ours: 



□ 

eter 



Odometer 



public class MainActivity extends Activity { 

^ We'll use this tov the 

private OdometerService odometer; OdomC'tevSevVite- 

private boolean bound = false; ^ Use ^ sW ^ ^ ^ 

activity s bound "to the service. 



private ServiceConnection connection = new ServiceConnection () { 

@ Override 

public void onServiceConnected (ComponentName componentName , IBinder binder) { 
OdometerService . OdometerBinder odometerBinder = 



app/src/main 

java_ 

MB 

com. hfad. odometer 

Lu 



Main 

Activity.java 



} 



} ; 



(OdometerService . OdometerBinder) binder ; 



} 



odometer = odometerBinder . getOdome ter (); ^^ 
bound = true; 

1/Vbcn “tbc scvvidc is dorme^ted, 
sc*t bound “to *brue. 



@ Override 

public void onServiceDisconnected (ComponentName 



Cast -tbc Binder {o an 
Odorweiev-Bindeir, ibcn use -fco gei a 
ire-Peirende -to ■the OdorwctevSeirviee- 

componentName) { 



bound = false; 

r 

When the seyvide is disdonnedted, 
set bound -to -false. 



When the service is connected, the onServiceConnected ( ) 
method uses the Binder object to get a reference to the 
service. We’re also using the onServiceConnected ( ) and 
onServiceDisconnected ( ) methods to record whether the 
service is currently connected. 
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bind and unbind 

Bind to the service when the activity starts 




Bind to Service 
Display miles 



We’re going to use the connection to bind to the service when the 
activity becomes visible. As a reminder, when an activity becomes 
visible, its on St art ( ) method gets called. 

To bind to the service, you first create an explicit intent that’s 
directed at the service you want to bind to. You then use the 
activity’s bindService () method to bind to the service: 

MainAc+ivi+y Odome+erService 

@ Override 

protected void onStart() { This is a* diverted 

super . onStart () ; bo the Odometev-Sev-vide- 

Intent intent = new Intent (this , OdometerService . class) ; 
bindService ( intent , connection , Context . BIND_AUTO_CREATE ) ; 

} ^ 

This uses -the m-teivt and service Connection 

The code Context . BIND_AUTO_CREATE tells Android to afr k |Vl fy -to the service- 

create the service if it doesn’t already exist. 




Unbind from the service when the activity stops 

When the activity loses visibility, we’re going to unbind from the 
service. When an activity loses visibility, its on St op ( ) method gets 
called. 

You unbind from the service using the unbindService ( ) 
connection. The method takes one parameter, our connection. 
We’re going to check whether the service is bound when the activity 
loses visibility, and if it is, we’ll unbind it: 




MainAc+ivi+y OdometerService 



@ Override 

protected void onStopO { 

super . onS top ( ) ; This uses *thc se\rvi£c £ormc£'tion 

if (bound) { u *kmd ^ ro "' sev-vide. 

unbindService (connection) ; 
bound = false; 

} 



□ 

Odometer 

4ni 

app/sre/main 

h a 

java 

com. hfad. odometer 

La 



So far we have an activity that binds to the service when the activity 
starts, and unbinds from the service when the activity stops. The 
final thing we need to do is get the activity to ask the service for the 
distance traveled. 



Main 

Activity.java 
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services 

Bind to Service 
Display miles 



Once you have a connection to the service, you can call its methods. 
We’re going to call the OdometerService getMiles ( ) 
method every second to get the distance traveled, and then use it 
to update the text view in the layout. We’ll call the getMiles ( ) 
method every second and update the text view each time it’s called. 

To do this, we’re going to write a new method called 
watchMileage ( ) . This works in exactly the same way as the 
runTimer ( ) method we used in Chapter 4. The only difference 
is that it displays miles traveled instead of elapsed time. 

Here’s our watchMileage ( ) method: 



1.11 miles 

a: 

The activity will use -the jetMilesO 
method in the Odometev-Sevvide to 
populate the ~fe*t\/iew. 



£jet the text view. 



private void watchMileage () { 

final TextView distanceView = (TextView) findViewBy Id (R. id. distance) ; 
final Handler handler = new Handler () ; ^ — Create a new Handler. 



handler. post (new RunnableO { — Call the postO method, passing in a new Runnable. 

@ Override 



} 



|-P we’ve ^ot a re*ferende to the Odometer£ervide> 
use its jetMilesO method- 



public void run() { 

double distance = 0.0; 
if (odometer != null) { ^ 

distance = odometer . getMiles ( ) ; Format the miles. 

> t 

String distanceStr = String . format ( M %1$ ,. 2f miles", distance); 
distanceView. setText (distanceStr) ; 



} 



}) 



handler .postDelayed (this , 1000) ; □ 

Odometer 

Post the dode in the Runnable to be run a$ain a*fter a delay o-P 

1,000 millisedonds, or I second- fa this line of dode is mdluded in the app/src/main 

Runnable runO method, it will run every sedond (with a slight laj)- I— f \ 



We’ll then call this method in the activity’s onCreate ( ) method 
so that it starts running when the activity gets created: 

QOverride 

protected void onCreate (Bundle savedlnstanceState) { 



java 



MT3 



com. hfad. odometer 

LQ 



Main 

Activity.java 



watchMileage () ; 

} 

Weil show you the full code for MainActivity on the next page. 
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MainActivity code 



The full MainActivityjava code 

Here’s the complete code for MainActivity] av a : 
package com. hfad . odometer ; 

import android. app .Activity; 

import android . content . ComponentName ; 

import android. content . Context; 

import android . content . Intent ; 

import android. content . ServiceConnection; 

import android. os . Bundle; 

import android. os . Handler ; 

import android . os . IBinder ; 

import android. widget . TextView; 






Bind to Service 
Display miles 



□ 

Odometer 

KU 

app/src/main 

java^ 

com. hfad. odometer 

L 0 

Main 

Activity.java 



public class MainActivity extends Activity { 

• We'll use "this -Cor -the OdometerService- 



private OdometerService odometer; 
private boolean bound = false; 






{ 



1/V t need i o 
de-fine a 

£ev-vi£eConne£*tion. 



' this “to store whether or not “the 
activity *s bound to the service- 

private ServiceConnection connection = new ServiceConnection ( ) 

@Override 

public void onServiceConnected (ComponentName componentName, IBinder binder) 
OdometerService . OdometerBinder odometerBinder = 

(OdometerService . OdometerBinder) bindery- 

odometer = odometerBinder . getOdometer () ; , o . . 

qet a I re+erenCe to the 

bound = true; OdometerService whe» the 

1 service is £onne£ted- 

@Override 

public void onServiceDisconnected (ComponentName componentName) { 
bound = false; 

} 



QOverride 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_main) ; 
watchMileage () ; * 



Call -the wat^hMileajeO -function when -the a^tivitys ev-ea- ted. 
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The MainActivity.java code (continued) 

@Override 

protected void onStart () { sev-vite y/i *bV\c activity starts- 

super . onStart () ; 

Intent intent = new Intent (this, OdometerService . class ) ; 
bindService ( intent , connection. Context . BIND_AUTO_CREATE) ; 



Unbind the servide when the adtivitv stops. 

OOverride 1 

protected void onStopO { 
super . onStop ( ) ; 
if (bound) { 

unbindService (connection) ; 
bound = false; 



} 






.This method updates the mileage that's displayed- 



□ 

Odometer 

413 

app/src/main 

KU 



java_ 

LQ 

com. hfad. odometer 




Main 

Activity.java 



private void watchMileage ( ) { 

final TextView distanceView = (TextView) findViewByld (R. id. distance) ; 
final Handler handler = new Handler (); 
handler . post (new Runnable () { 

QOverride 

public void run() { 

double distance = 0.0; |*f <y>t a to the 

if (odometer !« null) { ^ Odometer Wide, use its getMilesO method. 

distance = odometer . getMiles () ; 



} 



} 




String distanceStr = String . format ( M %1$ , 
distanceView. setText (distanceStr) ; 
handler .postDelayed (this, 1000) ; 






Update the distande every sedond- 



.2f miles". 



distance) ; 



That’s all the code you need to get MainActivity to use the 
OdometerService. Let’s see what happens when you run the code. 
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What happens when you run the code 

Before you see the app up and running, let’s go through what 
happens when the code runs: 




Bind to Service 
Display miles 



© 



When the MainActivity starts, the onStart() method creates a 
ServiceConnection . 

It asks to bind to the OdometerService. 




MainActivity ServiceConnection 



O The OdometerService starts and its onBind() method is called with a 
copy of the intent from the MainActivity. 



o 

MainActivity 




o 



ServiceConnection 



onBind() 
OdometerService 



O The onBindQ method returns a Binder object. 




MainActivity 



ServiceConnection 



onBind() 
OdometerService 
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The story continues 



O 



MainActivity gets a reference to OdometerService from the Binder 
and starts to use the service directly. 



getMilesQ 




MainActivity OdometerService 



© 



While MainActivity is running, the watchMileage() method calls the 
OdometerService getMiles() method every second and updates the 
screen. 



watchMileage() 




O 



When MainActivity stops, it disconnects from the OdometerService 
by calling unbindServiceQ. 




Let’s run the app and see what it does. 
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test drive 

h- 



Test drive the app 



□ 



Bind to Service 
Display miles 



To see the app in action, you’ll need to run it on a device that has a 
GPS. If you don’t, the app won’t work. 

When you start the app, it says the distance traveled is 0 miles. An 
icon appears at the top of the device indicating that the location 
service has been activated: 



The app stav-b ot-f - 
displaying 0.00 miles. 



0.00 miles 

This number may up 
slightly when you start the 
app. This is because it takes 
a tew seconds -for the 
to home in on the devide 
location, and it may initially 
misreport it- 



The location servide is 
. up and running- 

““Vx 



9 *a Q 16:19 



1.11 miles 

I^Vhen you take your devide 
tor a walk, the distande 
displayed indreases. 



< o □ 



When you take your device on a road trip, the I 

distance traveled increases. 



< o □ 



We foow you’re full of great ideas for 
improving the Odometer app, So why not 
try them out? As an example, why nottiy 
adding Start, Stop, and Reset buttons? 
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Your Android Toolbox 



You’ve got Chapter 13 under 
your belt and now you’ve 
added services to your toolbox. 



You tan download 
-the -full Code -for 
the Rafter from 

httfs ; / / tinyurl-tom/ 

Headf" irstAndroid- 




BULLET POINTS 



■ A service is a component that can perform 
tasks in the background. It doesn’t have a user 
interface. 



■ A started service can run in the background 
indefinitely, even when the activity that started 
it is destroyed. Once the operation is done, it 
stops itself. 

■ You declare services in AndmidMantfesixml 
using the <service> element. 

■ You can create a simple started service by 
extending the intentservice class and 
overriding its onHandleintent ( ) method. 
The intentservice class is designed for 
handling intents. 

■ You start a started service using the 

startService ( ) method. 

■ If you override the intentservice 
onStartCommand ( ) method, you must 
call its super implementation. 

■ You create a notification using a notification 
builder. You get your notification to start an 
activity using a pending intent. You then use 
Android’s notification service to display the 
notification. 



■ A bound service is bound to another component 
such as an activity. The activity can interact with 
it and get results. 



You usually create a bound service by extending 
the Service class. You must define your own 
Binder object, and override the onBind ( ) 
method. This is called when a component wants 
to bind to the service. 

The Service onCreate ( ) method is 
called when the service is created. Use it for 
instantiation. 

The Service onDestroy ( ) method 
is called when the service is about to be 
destroyed. 

You can use the Android location service to get 
the current location of the device. You create a 
LocationListener, and then register it 
with the location service. You can add criteria 
for how often the listener is notified of changes. 
When you use the device GPS, you need to add 
a permission for it in AndroidMantfest.xml. 

To bind an activity to a service, you create a 

ServiceConnection. You override the 
onServiceConnected ( ) method to get 
a reference to the service. 

You bind to the service using the 
bindService ( ) method. You unbind from 
the service using the unbindService ( ) 
method. 
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14 material design 



Living in n Mdt&ridl World ^ 




sat 



One v V— * 

player comes off 
the pitch, another player 
moves straight in. Just 
i like a recycler view. 



With API level 21, Google introduced Material Design. 

In this chapter, we’ll look at what Material Design is, and how to make your apps fit in 
with it. We’ll start by introducing you to card views you can reuse across your app for a 
consistent look and feel. Then we’ll introduce you to the recycler view, the list view’s 
flexible friend. Along the way, you’ll see how to create your own adapters, and how to 
completely change the look of a recycler view with just two lines of code. 



this is a new chapter 597 



material design 



Welcome to Material Pesign 

Material Design was launched with API level 2 1 and it’s 
intended to give a consistent look and feel to all Android apps. 
The idea is that a user can switch from a Google app like the 
Play Store to an app designed by a third-party developer and 
instantly feel comfortable and know what to do. The Material 
part of the name comes from Material Design’s visual style, 
which makes the parts of your interface look like overlapping 
pieces of material or paper: 




A Q 14:11 

Q, : 



= Notes 



Thai green curry 
Jacket potatoes 
Ragu Bolognese 
Chicken Noodle Soup 



Top Ten 

Broadcast receivers 
Web view 



Funghi 



\ q 

Welcome 

to 

Finland 

Walk 

dog 



Add quick note 



Mow 

lawn 



This is 

example 

text 



Material Design uses animation and 3D effects likes drop- 
shadows to make it clear to the user how they can interact with 
the app. To do this, Material Design includes a set of support 
libraries that contains different widgets and themes for use in 
Material Design apps. In this chapter, we’ll take a few of these 
widgets and use them to make the Pizza app we developed in 
Chapters 9 and 10 fit in with Material Design. 
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CardViews and RecyclerViews 

Two of the most important Material Design widgets are recycler views 
and card views. 

A card view is a container for other views. Card views have rounded 
corners, and a drop-shadow that makes them appear to be floating above 
the background. You can animate a card view so that it will appear to 
move when you push it. 

A recycler view is like a new kind of list view A recycler view gets 
its name because it can efficiently reuse (or recycle) views to create the 
appearance of a list on the screen. A recycler view can be used to display 
card views. 

We’re going to change the Pizza app so that it uses card views and recycler 
views. We’ll convert the app so that the list of pizzas goes 



from this: 



This is a normal - — ^ 
Tisil/icw. 



to this: 





This is a redydler 
view don-tainin^ 

. W dard views. 
£adh dard view 
don-tains -the 
name and imay 
of a piz^a. 




Geek Bits 



Material Design uses a lot of 3D 
effects. But doesn't this slow 
your device? On most devices, 
the answer is no. If possible, the 
Material views will try to use the 
power of the graphics hardware 
to generate the drop-shadows 
in much the same way that a 
game would. That means that 
not only are generated shadows 
rendered beautifully, but they 
also take no extra time to draw. 
On older devices, the views will 
insert shadow images behind 
each view. That will take a little 
extra processing power and some 
extra memory. If you want to run 
your app on a very old device, it's 
best to check it against an actual 
device before release. 



you are here ► 



599 





pizza again 



The Pizza app structure 



We’re going to change the app so that we use a card view and 
recycler view for the list of pizzas. Here’s a breakdown of how the 
app will be structured and what it will do: 



o 

© 

o 



When the app gets launched, it starts MainActivity. 

The activity uses layout activity_main.xml and has a navigation drawer. When the user clicks on 
one of the options in the navigation drawer, it displays the appropriate fragment. 

When the user clicks the Pizzas option, it displays PizzasMaterialFragment. 

PizzasMaterialFragment contains a recycler view. 

PizzaMaterialFragment uses an adapter, CaptionedlmagesAdapter, to display 
card views showing an image and caption for each pizza. 

The card views are defined in card_captioned_image.xml. Pizza data is held in Pizzas.java. 



© 

o 



When the user clicks on a pizza, details of the pizza are displayed in 
PizzaDetail Activity. 

When the user clicks on the Create Order action in the action bar of 
MainActivity or PizzaDetail Activity, Order Activity is displayed. 
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Add the pizza data 

We’ll start by adding the pizza images to the Bits and Pizzas project. 
Download the files diavolo.jpg and funghi.jpg from https://tinyurl.com/ 
HeadFirstAndroid. Then drag them to the folder app /src /main /res /draw able- 
nodpi. If Android Studio hasn’t created the folder for you, you’ll need to 
create it. 

We’re putting the images in the draw able-no dpi folder because we want the 
device to use the same images, regardless of the dpi of the screen. If you 
wanted, you could create separate images for different device resolutions 
and put them in the appropriate drawable* folder. 

Add the Pizza class 




We’re going to update the 
Pizza app in this chapter, 
so open your original 
Bits and Pizzas project in 
Android Studio. 



We’ll add a Pizza class to the app which the recycler view will get its ^ In a real app, we might use a 

pizza data from. The class defines an array of two pizzas, where each database -for this. 1/VeVe using a 

pizza is composed of a name and image resource ID. Add the class to the Java elass here -f or simplicity, 

com. hf ad . bitsandpizzas package in the app /src /main /java folder 
in your project, giving it a class name of Pizza. Then save your changes: 



package com. hf ad. bitsandpizzas; 



public class Pizza { 

private String name; 



Each Pizza has a na**e and image resource 
J |p. The image resource IP refers to the 
,Ur drink images we added to ihe projed-t above- 



private int imageResourceld; 



public static final Pizza [] pizzas = { 

new Pizza ( "Diavolo" , R. drawable . diavolo) , 
new Pi z za ( " Funghi ", R . drawable . f unghi ) 



}; 



v^" 



The Pizza Constructor 



private Pizza (String name, int imageResourceld) { 
this. name = name; 

this . imageResourceld = imageResourceld; 

} 



public String getName() 
return name; 

} 



^ These are getters (or 
^ private variables. 

\h 



the 



public int getImageResourceId() 
return imageResourceld; 

} 



} 



We’re going to use a recycler view and card view in the app, and these 
require support libraries. We’ll add these next. 



□ 

Bits And Pizzas 

43 

app/sre/main 

java_ 
com, hfad. bitsandpizzas 



Pizza .java 
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Add the support libraries 



Card views and recycler views 
come from the GardView and 
RecyclerView v7 libraries, so 
we need to add these libraries 
as dependencies. To do this, go 
to File— ^Project Structure. In 
the Project Structure window, 
select app and switch to the 
Dependencies tab. Then 
add library dependencies for 
recyclerview-v7 and cardview-v7. 




When you add dependencies, Android Studio records them in the app/ 
build. gradle file: 



dependencies 

compile 

compile 

compile 

compile 



{ 

f ileTree (dir : 
'com. android, 
'com. android, 
'com. android. 



'libs ' , include: ['*.jar']) ] 

support : appcompat-v7 : 2 1 . 0 . + ' \ 

support : recyclerview-v7 : 21 . 0 . +' 
support : cardview-v7 : 21 . 0 . +' > 



If you wish, you can manage the library dependencies for your app 
by editing this file directly. It will have the same effect as adding 
dependencies in the Project Structure window. 



Adding support libraries to 
•the window above updates 
build.<\v-adle behind the scenes. 

i □ 

BitsAndPizzas 




build. gradle 



Now that you’ve added the support libraries, we’ll create the card view. 
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Create the CardView 



You use card views to visually represent the basic data items in your app in 
a recognizable and coherent way The basic data items in our Pizza Shop 
app are pizzas, pasta, and stores, so we’re going to create a card view we 
can use to displays these items. 

You create a card view by including it in a layout. You can either add it 
to an existing layout, or create a new layout file for it. Creating a new 
layout file for the card view means that you can use the card view inside a 
recycler view. 

We want to use the card view inside a recycler view, so we’re going to put 
it in its own layout file. To do this, add a new layout file to the app/src/ 
main/res /layout folder called card_captioned_image.xml. 

You define a card view usin? code like this: , . , . ^ .. 

8 This adds -the CavdV lew- 

<android . support . v7 . widget . CardView 




T 



xmlns : android="http : //schemas . android.com/apk/res/android" 
xmlns : card_view="http : //schemas . android.com/apk/res-auto" 
android: id="@+id/card_view" p — j 

android: lay out_width=" mat ch_j?arent" BitsAnd Pizzas 



Cav- dV/icv/ is 

d subclass o-f 
Fra rt\ e Layout 



android: layout_height="200dp" 
android: layout_margin="5dp" 
card_view : cardCornerRadius="4dp"> 

</android . support . v7 . widget . CardView> 



This gives the 

Cardl/iew 

v-ouhded 

£o\rhers. 



The CardView class comes from the v7 CardView support library, so 
we have to use its full class path of android . support . v7 . widget . 
CardView. 



4U 

app/sre/main 

HU 




card_captioned. 

image.xml 



You give your card view rounded corners by adding a namespace of 

xmlns : card_view="http : //schemas . android.com/apk/res-auto" 



and using the card_view : cardCornerRadius attribute to set the 
corner radius. As an example, the code 

card_view : cardCornerRadius=" 4dp" 

sets the card corner radius to 4dp. 

You define the appearance of the card view by adding other views to 
it. In our case, we want to display an image and text in the card view. 
We’ll show you the full code on the next page 
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card_captioned_image code 



The full card_eaptionedJniage.xwl code 

Here’s the full code for card_captioned_image.xml (we’ve added a linear 
layout to the card view, and put an image view and text view inside the 
linear layout; we’ve taken this approach because the CardView class 
extends the FrameLayout class, and frame layouts are designed to hold 
a single child view — in this case, the frame layout has a single child view of 
a linear layout): 



<?xml version="1.0" encoding= M utf-8 M ?> 

<android . support . v7 . widget . CardView 

xmlns : android= M http : //schemas . android.com/apk/res/android" 
xmlns : card_view="http : //schemas . android.com/apk/res-auto" 
android: id="@+id/card_view" 
android : layout_width="match_j?arent" 

android: layout_height="200dp" tard view will be as wide as its 

android: lay out_margin="5dp" parent allows, and 2-00df bi^Vv 

card_view : cardCornerRadius= " 4dp " > 



□ 

BitsAndPizzas 

40 

app/sre/main 

L a 

res 

LQ 

layout 



card_captioned_ 

image.xml 



<LinearLayout 

android : layout_width="match_j?arent" 
android : layout_height=" f ill^parent" 

android: orienta tion=" vertical "> ^be image will be as wide as 

its parent allows. Were using 

<ImageView android: id="0+id/info_image" tei,, terCvop b> make sure ihe 

android: layout_height="Odp" image sdales uni ormly. 

android : layout_width="match_parent" 
android : layout_weight=" 1.0" 
android : scaleType=" centerCrop" /> 



<TextView 

android : id=" @+id/info_text" 
android : layou t_marginLe f t= " 5dp " 
android : layout_marginBottom=" 5dp" 
android : layout_height="wrap_content " 
android : layout_width="match_j?arent" /> 
</LinearLayout> 

</android . support . v7 . widget . CardView> 




We’ll be able to use this card view layout for any data items that consist of 
a caption and an image, such as our pizza data. 

The next thing we need to do is create a recycler view that will display a 
list of our card views. 
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RecyclerViews use RecyclerView.Adapters 



A recycler view is a more advanced version of a list view. Just like a list view, 
a recycler view is a scrollable container used for displaying sets of data. A 
recycler view, however, is more efficient at displaying large data sets. This is 
because a recycler view reuses (or recycles) views when they are no longer 
visible on screen, whereas a list view displays a new view for each item that 
appears on screen. 

Just like a list view, you add data to a recycler view using an adapter. 

Unfortunately, recycler views don’t work with any of the built-in adapters 
such as array adapters or cursor adapters. Instead, you have to create your 
own that’s a subclass of the RecyclerView . Adapter class. 

The adapter uses 
the data you 
^ — - syedity- I* our 
ease, this will be 
data -from the 
Pizza dlass. 

r 

Vou write the adapter yourselt 

The adapter has two main jobs: to create each of the views that are visible 
within the recycler view, and to configure the view to match a piece of 
data. 



The \redyele\r view 
uses the adapter.—^. 



Recycler 

View 



>^> 




In our case, the recycler view needs to display a list of cards, each 
containing an image view and a text view. This means that the adapter 
needs to create views for these items, and replace their contents when each 
item in the data set is no longer visible. 

Over the next few pages, we’re going to create a recycler view adapter. We 
need it to do three things: 



o 

© 

© 



Specify what type of data the adapter should work with. 

We need to tell the adapter to use card views. Each card view needs to 
be populated with an image and its caption. 

Create the views. 

The adapter needs to create all of the views that will need to be 
displayed on screen. 

Bind the data to the views. 

The adapter needs to populate each of the views with data when it 
becomes visible. 



We’ll start by adding a RecyclerView . Adapter class to our project. 
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Create the basic adapter 

We’re going to create a recycler view adapter called 

CaptionedlmagesAdapter. Create a new class called 

Cap tionedlmages Adapter, then replace the code with the following: 

package com . hfad . bitsandpizzas ; 

/ RedV^lcvView t\ass is m 3 support library. 

import android, support .v7 .widget . RecyclerView ; K I 

import android . view . ViewGroup ; 



clas s CaptionedlmagesAdapter extends RecyclerView . Adapter<Cap tionedlmages Adapter . ViewHolder> { 
//Provide a reference to the views used in the recycler view 
public static class ViewHolder extends RecyclerView . ViewHolder { 

//Define the view holder ^ ^ need ^ ^ VlMey .. 

Well do this ot\ -the page. 1 I 



} 



BitsAndPizzas 



@ Override 

public CaptionedlmagesAdapter .ViewHolder onCreateViewHolder ( 
ViewGroup parent , int viewType) { 

//Create a new view 

> V 

You y\ttd bo implement these methods. 

@ Override 

public void onBindViewHolder (ViewHolder holder , int position) { 
//Set the values inside the given view 

} 

You must implement this method too. 

@ Override 

public int getltemCount () { 

//Return the number of items in the data set 

} 



K3 

app/sre/main 

4H 



java 



LQ 



com. hfad. bitsandpizzas 

l£) 

Captionedlmages 

Adapter.java 



As you can see, the CaptionedlmagesAdapter extends the 
RecyclerView . Adapter class and implements its getltemCount ( ) , 
onCreateViewHolder ( ) , and onBindViewHolder ( ) methods. 

The getltemCount ( ) method is used to return the number of items 
in the data set, the onCreateViewHolder ( ) method is used to create 
the views, and the onBindViewHolder ( ) is used to set the values inside 
the views. You must override these methods whenever you create your own 
recycler view adapter 

The class also defines a view holder, which you use to say what data the 
adapter should work with. We’ll look at this next. 
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Refine the adapter's ViewHolder 

A view holder provides a reference to the view or views for each 
data item in the recycler view. It’s a holder for the views you want 
to display 

When you create a recycler view adapter, you need to create 
a view holder inside the adapter. You do this by extending the 
RecyclerView . ViewHolder class, and specifying what type 
of data it should hold. 

Each data item in our recycler view is a card view, so we need to 
make our view holder store card views. Here’s the code: 

package com.hfad.bitsandpizzas; 



A l/iewttoldev- holds one ov- mov-e V'\ ews. 




import android . support . v7 . widget . CardView ; 



class CaptionedlmagesAdapter extends RecyclerView. Adapter<CaptionedImagesAdapter . ViewHolder>{ 
//Provide a reference to the views used in the recycler view 
public static class ViewHolder extends RecyclerView. ViewHolder { 

private CardView cardView; ^ — □ 

JPizz 

app/sre/main 



} 



public ViewHolder (CardView v) { 



super (v) ; 
cardView = v; 




} 



A 

Ouv vefiydlev view needs -to display CavdViews, 
so we spedi-fy -tha-t owe Viewttoldev- don-tains 
Cavd\/iews. It you want to display another type 
of data in the vedydlev view, you de-fine it here- 



BitsAndPizzas 






When you create a view holder, you must call the ViewHolder 
super constructor using: 



java_ 

com.hfad.bitsandpizzas 

L 0 

Captionedlmages 

Adapter.java 



super (v) ; 



This is because the ViewHolder superclass includes metadata 
such as the item’s position in the recycler view, and you need this 
for the adapter to work properly. 

Now that we’ve created a view holder to store card views, we’ll get 
the adapter to display the card views in the recycler view. 
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Create the ViewHolders 



The recycler view maintains a fixed set of view holders that contain 
the views that appear in the list on the screen. The number of view 
holders depends on the size of the screen they need to appear on, 
and how much space each item takes up. To enable the recycler view 
to figure out how many view holders it needs to maintain, you need 
to tell it which layout to use for each view holder in the adapter’s 
onCreateViewHolder ( ) method. 

When the recycler view is first constructed, it builds this set of view 
holders by repeatedly calling the adapter’s onCreateViewHolder ( ) 
method until all the view holders it needs have been created. The 
onCreateViewHolder ( ) method takes two parameters: the 
ViewGroup parent object (the recycler view itself) and an int 
parameter called viewType. This is used if you want to display 
different kinds of views for different items in the list. 

We want to create view holders that contains a card view based on our 
card_captioned_image.xml layout. Here’s the code that will do that: 



import android. view. Layoutlnf later; 

class CaptionedlmagesAdapter extends RecyclerView. Adapter<CaptionedImagesAdapter . ViewHolder>{ 



□ 



BitsAndPizzas 



@0verride 

public CaptionedlmagesAdapter .ViewHolder onCreateViewHolder ( 




app/src/main 




ViewGroup parent , int viewType) { 



CardView cv = (CardView) Layoutlnf later . from (parent .getContext () ) 



. inflate (R . layout . card_captioned_image , parent , false ) ; 



com.hfad.bitsandpizzas 



return new ViewHolder (cv) ; 





Captionedlmages 

Adapter.java 



Now that the adapter can create the view holders in the recycler view, 
we need to get the adapter to populate the card views they contain with 
data. 
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Each card view displays an image and a caption 



Each time the user scrolls the recycler view and a new item appears, the 
recycler view will take one of the view holders in its pool and call the 
onBindViewHolder ( ) method to bind data to its contents. The code 
in the onBindViewHolder ( ) method needs to set the contents of the 
views in the view holder so that they match the data. 

In our case, the view holder contains card views that we need to populate 
with images and captions. To do this, we’ll add a constructor to the 
adapter so that the recycler view can pass data to it. We’ll then use the 
onBindViewHolder ( ) method to bind the data to the card views. 

Create the constructor 

The recycler view needs to pass arrays of captions and image IDs to the 
adapter, so we’ll add a constructor that will take these as parameters. 
We’ll store the arrays in instance variables. We’ll also use the number of 
captions passed to the adapter to determine the number of items in the 
data set: 




Ba£h Cardl/iew doh-taihS a 
TextView and In^ajel/iew. Wc need 
■to populate these with the daption 
and image of eadh piz^a. 



class CaptionedlmagesAdapter extends RecyclerView. Adapter<CaptionedImagesAdapter . ViewHolder>{ 



private String [] captions; 

private int [ ] imagelds ; VS We'll use -these variables 

to bold the yizxa data 



□ 

BitsAndPizzas 

413 

app/sre/main 

nn 



public CaptionedlmagesAdapter (String [ ] 
this . captions = captions; 
this . imagelds = imagelds; 



} 



captions , int [ ] imagelds) { 

Wt II pass the data to the 
adapter using its Constructor. 



java_ 

com.hfad.bitsandpizzas 




Captionedlmages 

Adapter.java 



@Override 

public int getltemCount ( ) { 

return captions. length; <-'TK e | e „<yth of the Captions array equals the 
} number of data items in the redytler view. 



Now that the adapter can receive the data, we’ll get the adapter to 
display it in the recycler view by writing the onBindViewHolder ( ) 
method. 
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Add the data to the card views 



The onBindViewH older ( ) method gets called whenever the 
recycler view needs to display data in a view holder. It takes two 
parameters: the view holder that data needs to be bound to, and 
the position in the data set of the data that needs to be bound. 



We need to populate our card view with data. The card view 
contains two views, an image view with an ID of inf o_image, 
and a text view with an ID of inf o_text. We’ll populate these 
with data from the captions and image Ids arrays. 

Here’s the code that will do that: 



□ 

BitsAndPizzas 

M3 

app/src/main 

MB 



java 



import android, widget . ImageView; ^ _ 

import android . widget . TextView ; 

import android . graphics . drawable . Drawable ; 



WieYe using -these e%*bra classes. 



LQ 



com.hfad.bitsandpizzas 

|f] 

Captionedlmages 
Adapter, java 



class CaptionedlmagesAdapter extends RecyclerView. Adapter<CaptionedImagesAdapter . ViewHolder>{ 



private String [] captions; 

private int[] imagelds; These variables donta'm 

•the taptioM and i*»aje 

vesouvte IPs o£ “the pizzas. 



Display -the image 

public void onBindViewHolder (ViewHolder holder, int position)! in -the (magel/iev/. 
CardView cardView = holder . cardView ; 

ImageView imageView = (ImageView) cardView. findViewById(R. id. inf o_image) ; 
Drawable drawable = cardView. getResources (). getDrawable (imagelds [position] ) ; 
imageView. set ImageDrawable (drawable) ; 
imageView. setContentDescription (captions [position] ) ; 

TextView textView = (TextView) cardView. findViewById(R. id. inf o_text) ; 
textView . setText (captions [position] ) ; 

} i 



Display -the dap-tion in -the Te'/.'tView. 



That’s all the code we need for our adapter. We’ll show you the 
full code on the next page. 
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The full code for CaptionedlwagesAdapter.java 

package com.hfad.bitsandpizzas; 

import android. support . v7 .widget .RecyclerView; ) 
import android. view. Layoutlnf later; / 

import android. view. ViewGroup; / . > 

import android . support . v7 . widget . CardView; ^ These are the C asses we re 

import android. widget . ImageView; \ usin<y 

import android. widget . TextView; 

import android. graphics . drawable . Drawable; J 



private String [ ] captions; 
private int [ ] imagelds; 



class CaptionedlmagesAdapter extends RecyclerView. Adapter<CaptionedImagesAdapter .ViewHolder>{ 

□ 

BitsAndPizzas 

public static class ViewHolder extends RecyclerView. ViewHolder{ . * 

^ 1 app/sre/main 

private CardView cardView; I 

public ViewHolder (CardView v) { IHH 

super (v) ; 

Bath l/iewttoldev will display a Cardl/W 



java 



cardView = v; 



mi 



com.hfad.bitsandpizzas 



public CaptionedlmagesAdapter (String [ ] captions, int[] imagelds) { 
this . captions = captions; ^ 

this . imagelds = imagelds; Pass da* la to the adapt er in i*ts donstrudtor. 



Captionedlmages 

Adapter.java 



@ Over ride 

public CaptionedlmagesAdapter .ViewHolder onCreateViewHolder (ViewGroup parent, int viewType) { 
CardView cv = (CardView) Layoutlnf later . from (parent . getContext () ) 

. inf late (R. layout . card_captioned_image, parent, false); 
return new ViewHolder (cv) ; T 

} Use our layout -for -the Card\/iews. 

public void onBindViewHolder (ViewHolder holder, int position) { 

CardView cardView = holder . cardView; 

ImageView imageView = (ImageView) cardView. findViewByld (R. id. inf o_image) ; 

Drawable drawable = cardView. getResources () .getDrawable (imagelds [position] ) ; 

imageView. setlmageDrawable (drawable) ; 

imageView. setContentDescription (captions [position] ) ; 

TextView textView = (TextView) cardView. findViewByld (R. id. info_text) ; 
textView . setText (captions [position] ) ; ^ 

} ' Populate the Car d\/iev/s |ma$e\/iew 

and Te*t\/iew with data- 

@ Over ride 

public int getltemCount ( ) { 

return captions . length; The number o-P data items. 

} 



} 
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Create the recycler view 



So far we’ve created a card view and an adapter. The next thing 
we need to do is create the recycler view. The recycler view will 
pass the adapter pizza data so that it can populate the card views 
with pizzas. 

We’re going to put the recycler view in a new fragment. This is 
because we’re going to display it in Main Activity whenever 
the user clicks on the Pizzas option in the navigation drawer: 



We’ll start by creating the fragment. Add a new blank 
fragment to your project. Give the fragment a name of 
“PizzaMaterialFragment” and a layout name of “fragment_pizza_ 
material”. 

On the next page, we’ll add the recycler view to the layout. 
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Add the RecyclerView to the layout 



You add a re cycler view to the layout using the 
<android . support . v7 . widget . RecyclerView> 
element. 



Here’s the code for Jragmmt_pizza_material.xml ; it contains a 
recycler view with an ID of pi zza_re cycler: 



□ 



BitsAndPizzas 



<?xml version="1.0" encoding="utf-8"?> 

<android . support . v7 . widget . RecyclerView 

xmlns : android= M http : //schemas . android.com/apk/res/android" 
android: id="@+id/pizza_recycler" ^ 

android: scrollbars=" vertical" ^ ‘^ ,s a Re£y£le\rl/iew 

android : layout_width="match_jparent" 
android : layout_height="match_parent " /> 



4U 

app/src/main 



res 



with a veirtidal sdvollbav-. 



LQ 

layout 



fragment_pizza_ 

material.xml 



You add scrollbars to the recycler view using the 
android: scrollbars attribute. We’ve set this to 
"vertical" because we want our recycler view to display a 
vertical list that will scroll vertically. 

Now that we’ve added a recycler view to fragment_pizza_ material 
xml , we need to add code to PizzaMaterialFragment.java to control 
its behavior. 



Using the adapter 

In the code for PizzaMaterialFragment.java , we’ll get the recycler 
view to use the adapter. We need to tell the adapter what 
data to use via the adapter’s constructor, and then use the 
RecyclerView setAdapter ( ) method to assign the adapter 
to the re cycler view: 



Recycler 

View 



Adapter 

b 



Data 



We’ll show you the code for PizzciMateria IFragmen t.java on the next 
page. 
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PizzaMaterialFragment code 



The PizzaMaterialFragwent.java code 

Here’s the code for PizzaMaterialFragment. jay a (it creates an instance of 
CaptionedlmagesAdapter, tells it to use pizza names and images 
for its data, and assigns the adapter to the recycler view): 

package com . hfad . bitsandpizzas ; 



import android . app . Fragment ; 
import android . os . Bundle ; 

import android . support . v7 . widget . RecyclerView ; 
import android . view . Layoutlnf later ; 
import android . view . View ; ' 

import android . view . ViewGroup ; 



□ 

Pizz 

K3 



BitsAndPizzas 



VVcVc us these classes. 



app/sre/main 

L a 

java_ 

com, hfad. bitsandpizzas 



public class PizzaMaterialFragment extends Fragment { 



PizzaMaterial 
Fragment, java 



@ Override 

public View onCreateView (Layoutlnf later inf later, ViewGroup container, 

Bundle savedlnstanceState) { 

RecyclerView pizzaRecycler = (RecyclerView) inf later . inf late ( 

R. layout . f ragmen t_pizza_ma ter ial , container , false) ; 

Wse the layout we updated 

String[] pizzaNames = new String [Pizza, pizzas . length] ; °* the previous page- 

for (int i = 0; i < pizzaNames . length; i++) { 

pizzaNames [i] = Pizza. pizzas [i] .getName() ; ^e pizza *ar*es to a* array 

} o( Strips, and the pizza ir»a$es 

to a* array o( mts. 

int[] pizzalmages = new int [Pizza. pizzas . length] ; 
for (int i = 0; i < pizzalmages . length; i++) { 

pizzalmages [i] = Pizza. pizzas [i] . getlmageResourceld ( ) ; 

* - Pass the arrays to the adapter. 






CaptionedlmagesAdapter adapter = new CaptionedlmagesAdapter (pizzaNames , pizzalmages) 
pizzaRecycler . setAdapter (adapter) ; 
return pizzaRecycler; 



There’s just one more thing we need to do: we need to specify how 
the views in the recycler view should be arranged. 
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A RecyclerView uses a layout 
manager to arrange its views 

One of the ways in which a recycler view is more flexible than a 
list view is when it comes to arranging its views. A list view displays 
its views in a single vertical list, but a recycler view gives you more 
options. You can choose to display views in a linear list, a grid, or a 
staggered grid. 

You specify how to arrange the views using a layout manager. The 
layout manager positions views inside a recycler view, and the type 
of layout manager you use determines how items are positioned: 



V A □ 13:38 



= Pizzas : 




LinearlayoutManager 

This arranges items in a 
vertical or horizontal list. 



On the next page, we’ll show you how 
manager to use. 




GridlayoutManager 

This arranges items in a grid. 



specify which layout 



• 

= Notes 


Q 14:11 | 

Q. : 


Add quick note 


B !S 0 


Mow 

lawn 


Welcome 

to 

Finland 


This is 

example 

text 


Walk 

dog 


Thai green curry 
Jacket potatoes 
Ragu Bolognese 
Chicken Noodle Soup 


Top Ten 

Broadcast receivers 
Web view 


<3 O □ 






Staggered&rid 

LayoutManager 

This arranges 
unevenly sized items 
in a staggered grid. 
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layout managers 



Specifying the layout manager 

You specify the layout manager, using the following lines of code: 



LinearLayoutManager layoutManager = new LinearLayoutManager (getActivity ()) ; 
pizzaRecycler . setLayoutManager (layoutManager) ; ^ 



The above code tells the recycler view to use a 
LinearLayoutManager, so all the views in the recycler view 
will be displayed in a list: 



This weeds -to be a Cowte*t It y°* 
use ■this to de iw aw activity, y<w we 
this iwstead ot jetActivityO. 



• 


▼ ^ □ 13:38 ■ 


= Pizzas 


h 5 


— . _ 




Diavolo 




p. .i-i 

LSI 


* 5 1 



When 



you use a 



items are displayed in a 
linear list- 



Funghi 



Using a layout manager means that it’s easy to change the 
appearance of your recycler view If you want to display your views 
in a grid instead, for instance, you just change the code to use a 
GridLayoutManager instead: 

GridLayoutManager layoutManager = new GridLayoutManager (getActivity () , 2); 



pizzaRecycler . setLayoutManager (layoutManager) ; 



« 


▼ ^ □ 13:39 


= Pizzas 


B + = 1 


|pj!i 





Funghi 






This says that the 
GridLayout Manager 
should be two Columns 
wide- 



When you change it to a 
GridLayoutManager, items 
are displayed in a grid. 
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The full PizzaMaterialFragment.java code 

Here’s the full code for PizzaMaterialFragment.java'. 



package com. hfad. bitsandpizzas; 



import android. app . Fragment; 
import android. os . Bundle; 

import android . support . v7 . widget . Linear LayoutManager ; 

import android. support . v7 . widget . RecyclerView; 
import android. view . Layoutlnf later ; 
import android. view .View; 
import android. view .ViewGroup; 

public class PizzaMaterialFragment extends Fragment { 



WieVe us'rn^ "tVns t lass, so wc 
nttd bo import \b 



□ 

Pizz 

ZJ 



BitsAndPizzas 



app/src/main 

43 

java_ 

■ 

“tr“ 



@Override 

public View onCreateView (Layoutlnf later inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

RecyclerView pizzaRecycler = (RecyclerView) inf later . inf late ( 

R. layout . fragment pizza material, container, false); 



PizzaMaterial 

Fragment.java 



String [] pizzaNames = new String [Pizza .pizzas . length] ; 
for (int i = 0; i < pizzaNames . length; i++) { 

pizzaNames [ i ] = Pizza . pizzas [i ]. getName () ; 

} 




AH ibis to de slays bhe same- 



int [ ] pizzalmages = new int [Pizza. pizzas . length] ; 
for (int i = 0; i < pizzalmages . length; i++) { 

pizzalmages [ i ] = Pizza .pizzas [i] . getlmageResourceld () ; 

} 



} 



CaptionedlmagesAdapter adapter = new CaptionedlmagesAdapter (pizzaNames, pizzalmages) 
pizzaRecycler . setAdapter (adapter) ; 

LinearLayoutManager layoutManager = new Linear Layou tManager (getActivity ()) ; 
pizzaRecycler . setLayou tManager (layoutManager) ; 

return pizzaRecycler; K k> display 

-t^c Cav-d\/ic>MS m a Imcav- 

lis*t, so wcVc us'm^ d 



L'mcav-Layou-tMa^ayv-. 

Now that we’ve finished the recycler view code, let’s change 
MainActivity so that it’s displayed when the user clicks on the 
Pizzas option in the navigation drawer. 
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use PizzaMaterialFragment 



fret MainActivity to use the new PizzaMaterialFragment 

When the user clicks on the Pizzas option, the List Fragment 
called PizzaFragment currently gets displayed. To display 
PizzaMaterialFragment instead, we need to replace all 
references to PizzaFragment in our MainActivity code 
with PizzaMaterialFragment. 

PizzaFragment is used two times in MainActivity.] av a , in its 
onCreate ( ) and select I tern ( ) methods. Change these 
lines of code to use PizzaMaterialFragment instead: 



package com.hfad.bitsandpizzas; 

public class MainActivity extends Activity { 



□ 

BitsAndPizzas 

4B 



QOverride 

protected void onCreate (Bundle savedlnstanceState) { 

getFragmentManager () . addOnBackStackChangedListener ( 
new FragmentManager . OnBackStackChangedListener ( ) 
public void onBackStackChanged ( ) { 



app/src/main 

H3 



java 






com.hfad.bitsandpizzas 



MainActivity.java 



if (fragment instanceof PizzaMaterialFragment) { 

currentPosition = 1 

} 

} 

private void selectltem ( int position) { 

switch (position) { 
case 1 : 

fragment = new PizzaMaterialFragment () ; 

break; 






We've Mi** ouv «e*/ PirzaMatevialfva$ment 
instead of Piziafvaynent- This means that 
when the usev dlidks on the option m 

the navigation dvawev, o«v shiny new vedydlev 
ist will be displayed- 



Before we run the app, let’s go through what the code we’ve 
written so far will do. 
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What happens when the code runs 



O 



The user clicks on the Pizzas option in the navigation drawer. 

Code in MainActivity runs to display PizzaMaterialFragment, and 
PizzaMaterialFragment’s onCreateView ( ) method runs. 




MainActivity 



PizzaMaterialFragment 



o 



The PizzaMaterialFragment onCreateView() method creates a 
LinearLayoutManager and assigns it to the recycler view. 

The LinearLayoutManager means that the views will be displayed in a list. As 
the recycler view has a vertical scrollbar, the list will be displayed vertically. 




LinearLayoutManager 



o 



The PizzaMaterialFragment onCreateView() method creates a new 
Captionedlmages Adapter . 

It passes the names and images of the pizzas to the adapter using the adapter’s 
constructor, and sets the adapter to the recycler view. 
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what happens 



The story continues 



O 



The adapter creates a view holder for each of the CardViews the 
recycler view needs to display. 




ViewHolder CardView 



@ The adapter then binds the pizza names and images to the text view 




Next, let’s run the app and see how it looks. 
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Test drive the app 

Run the app, open the navigation drawer, and click on the 
Pizzas option. 




Home 



Pizzas 

Pasta 

Stores 

Me* you t\\(M oy\ 

-the Pizzas option, 
Piz^Matev-ialPv-a^ent 
is displayed- It Contains 
a linear list o-f eard 
views populated with 
piz^a data. 



< o 





The recycler view is displayed containing a linear list of 
card views. Each card view contains pizza data. 
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magnets 




RecyclerView Magnets 



Use the magnets on this page and the next to create a new recycler view 
for the pasta dishes. The recycler view should contain a linear list of card 
views, each one displaying the name and image of a pasta dish. 



-This is *thc Lode -for *thc Pasta dass. 



package com. hfad. bitsandpizzas; 



public class Pasta { 

private String name; 
private int imageResourceid; 



□ 

BitsAndPizzas 

Ha 

app/sre/main 

43 



public static final [] pastas = { 

new Pasta ( "Spaghetti Bolognese", R. drawable . spag_bol ) , 
new Pasta ( "Lasagne" , R. drawable . lasagne) 

} ; 



java_ 

m3 

com. hfad. bitsandpizzas 




Pasta .java 



private Pasta (String name, int imageResourceid) { 
this. name = name; 

this . imageResourceid = imageResourceid; 

} 



getName () 




public String { 

return name; 

} 

public int { 

return imageResourceid; 

} 



1 android: scrollbars | 


RecyclerView | 


i 






1 android . support . v7 . widget . RecyclerView 


, 0 




"vertical" J | getImage ResourceId() | 


i 



This is the £ode to\r the layout- 






xmlns : android="http : / / schemas . android. com/ apk/ res/android" 
android: id=" @+id/pasta_recycler " 



android : layout_width="match_parent" 
android : layout_height="match_parent " / > 



□ 

BitsAndPizzas 

4 n 

app/sre/main 

KCJ 




fragment_pasta_ 
material. xml 
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This is the todc V PastaMatevialFvajment java 



□ 



BitsAndPizzas 



public class PastaMaterialFragment extends Fragment { 



@ Over ride 



413 

app/src/main 

HH 



public View onCreateView (Layoutlnf later inf later, ViewGroup container, java 

Bundle savedlnstanceState) { 

RecyclerView pastaRecycler = (RecyclerView) inf later . inf late ( 



, container, false) ; 



MT3 

com.hfad.bitsandpizzas 

L @ 
Pasta 

Material 
Fragment.java 



String [] pastaNames = new String [Pasta . pastas . length] ; 
for (int i = 0; i < pastaNames . length; i++) { 

pastaNames [ i ] = Pasta . pastas [ i ] . getName ( ) ; 

} 



int [ ] pastalmages = new int [Pasta .pastas . length] ; 
for (int i = 0; i < pastalmages . length; i++) { 

pastalmages [i] = Pasta. pastas [i] . getlmageResourceld () ; 

} 



adapter = 



new (pastaNames, ) ; 

pastaRecycler. setAdapter (adapter) ; 

layoutManager = new (getActivity ( ) ) ; 

pastaRecycler. setLayoutManager (layoutManager) ; 
return pastaRecycler; 



| Cap tionedlmages Adapter 1 


ArrayAdapter | 


^^aptionedlmagesAdapter j 


1 LinearLayout J . 


J LinearLayoutManager | 


|~ R . layout ■ fragment jastajaterxalJ 


r pastalmages | LinearLayout | 


1 ArravAdanfar« 1 


f LinearLayoutManagerl — [ 
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RecyclerView Magnets Solution 

Use the magnets on this page and the next to create a new recycler view 
for the pasta dishes. The recycler view should contain a linear list of card 
views, each one displaying the name and image of a pasta dish. 



package com. hfad. bitsandpizzas; 



□ 

BitsAndPizzas 



public class Pasta { 

private String name; 
private int imageResourceid; 



public static final 

new Pasta ( "Spaghetti 
new Pasta ( "Lasagne " , 

}; 




It’s a* away <1 Pasta objedts- 

[] pastas = { 

Bolognese", R . drawable . spag_bol ) , 
R. drawable . lasagne) 



Ha 

app/src/main 

4U 

java_ 

HT3 

com. hfad. bitsandpizzas 




Pasta .java 



private Pasta (String name, int imageResourceid) { 
this. name = name; 

this . imageResourceid = imageResourceid; 



public String > 



getName () 



1 



return name; 



These methods dire used by 

P^staAlateHalFragmehtjava. 



| getlmageRe source Id ( ) ^ ^ 



RecyclerView | 

^ — 

This is a spav-e magnet- 



public int 

return imageResourceid; 



4 



Add the redydler view to the layout- 



android . support . v7^wid get . RecyclerView~| 

xmlns : android="http : / / schemas . android. com/ apk/ res/android" 
android: id=" @+id/pasta_recycler" 



□ 



BitsAndPizzas 



HU 

app/src/main 




"vertical" 



Jj ^ Add vertical sevollbavs. 



L D 



android : layout_width="match_parent" 
android : layout_height="match_parent " / > 



CO 

MU 

layout 



fragment_pasta_ 
material. xml 
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public class PastaMaterialFragment extends Fragment { 



□ 

Pizz 



BitsAndPizzas 



app/src/main 

@ Over ride MB 

public View onCreateView (Layoutlnf later inf later, ViewGroup container, ^ 

com.hfad.bitsandpizzas 

L @ 

Pasta 

container, false) ; 



Bundle savedinstanceState) { 



RecyclerView pastaRecycler = (RecyclerView) inf later . inf late ( 

Use this layout — ^ r „ n fragment jasta.materiaiTj , 



String [ ] pastaNames = new String [Pasta . pastas . length] ; 
for (int i = 0; i < pastaNames . length; i++) { 

pastaNames [ i ] = Pasta . pastas [ i ] . getName ( ) ; 

} 



Material 

Fragment.java 



int [ ] pastalmages = new int [Pasta. pastas . length] ; 
for (int i = 0; i < pastalmages . length; i++) { 

pastalmages [i] = Pasta. pastas [i] . getlmageResourceld () ; 

} Were using the 

^r~~ ^ CaptionedlmagesAdaptei 

| CaptionedlmagesAdapter \ adapter = *<ro{ e earlier. 



CaptionedlmagesAdapter J 



Pass the pasta names and 
images to the adapter. 



(pastaNames, 



pastaRecycler. setAdapter (adapter) ; 




LinearLayoutManag ^ layoutManager 

pastaRecycler. setLayoutManager (layoutManager) ; 
return pastaRecycler; ^ 

Use the LmeavLayou-tMana^ev -to 

display -the dard views m a linear list- 



|~ LinearLayoutManag 



(getActivity ( ) ) ; 



You didn't need to use 



LinearLayout n>a^ets. 

■L 




LinearLayout j 


l i 


[ ArrayAdapter 


r ArrayAdapter n 
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where we are 



Where we've got to 



Here’s a reminder of where we’ve got to with our app: 



o 

o 

o 



When the app gets launched, it starts MainActivity. 

The activity uses layout activity _main.xml and has a navigation drawer. When the user clicks on 
one of the options in the navigation drawer it displays the appropriate fragment. 

When the user clicks the Pizzas option, it displays PizzasMaterialFragment. 

PizzasMaterialFragment contains a recycler view. 

PizzaMaterialFragment uses an adapter, Captionedlmages Adapter, to display 
card views showing an image and caption for each pizza. 

The card views are defined in card_captioned_image.xml. 




The next thing we need to do is get the recycler view to respond to 
clicks so it starts Pi zzaDe tail Activity when the user clicks 
on one of the pizzas. PizzaDetailActivity will then display 
details of the pizza the user selected. 

We’ll create PizzaDetailActivity next. 
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Create PizzaPetailActivity 

PizzaDetailActivity will display the name of the pizza the 
user selected, along with its image. 

Create a new blank activity called “PizzaDetailActivity 55 with a 
layout name of “activity_pizza_detail” and a title of “Pizza Detail 55 . 
Then update activity _pizza_detail xml with the code below, which 
adds a text view and image view to the layout that we’ll use to 
display details of the pizza: 



□ 



<LinearLayout xmlns : android= M http : //schemas . android . com/ apk/res /android 
xmlns : tool s=" http : //schemas . android.com/tools 

android: layout_width="match_j?arent" BitsAndPizzas 

android : layout_height="match_j?arent" 43 

android : orientation= M vertical " app/src/main 

tools : context= M com.hfad.bitsandpizzas . PizzaDetailActivity M > L Q 

PizzaDe-tailAawi iy don-tains 

<TextView 

android: id="@+id/pizza_text" 
android : layout_width="wrap_content" 
android : layout_height= M wrap_content " 

android: textAppearance= M ? android: attr/textAppearanceLarge" /> 



res 



a Tc%*b\/ic>w 3nd 3* | may View* 

WcMl put the n3mC ok the piz-Z-3 
in -the Te^iy/iew and -the s 
imay in ihe Iwayy/ie'M- 



43 

layout 



activity_pizza_ 
detail. xml 



<ImageView 

android: id="@+id/pizza_image" 
android : layout_height="wrap_content" 
android : layout_width="match_j?arent" 
android : ad jus tViewBounds= M true" /> 

</LinearLayout> 

We’ll look at what we need the code for PizzaDetailActivity.java to 
do on the next page. 
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requirements 



What PizzaPetailActivity-java needs to do 

There are a few things that we need PizzciDetailA ctivity.java to 
do: 



o 



PizzaDetailActivity’s main purpose is to display the name 
and image of the pizza the user has selected. To do this, we’ll get 
the ID of the pizza the user has selected from the intent that started 
the activity. We’ll pass this to PizzaDetailActivity from 
PizzaMaterialFragment when the user clicks on one of the 
pizzas in the recycler view. 



o 



Back in Chapter 9, we created a menu resource file that 
describes items we wanted to add to the action bar. We’ll 
use the onCreateOptionsMenu ( ) to add these items to 
PizzaDetailActivity’s action bar. 



o 



The menu resource file describes a Share action that we can use to 
share information. We’ll add an intent to the Share action that will 
share the name of the pizza the user has selected. 



o 

o 



The menu resource file also describes a Create Order action. When 
the user clicks on this, we’ll start Order Activity. 

We’ll enable the PizzaDetailActivity’s Up button so that 
when the user clicks on it, they get returned to MainActivity. 



Update AndroidMawifest-xwl 

We’ll start by updating AndroidManifest.xml to specify that 
MainActivity is the parent of PizzaDetailActivity. 

This means that when the user clicks on the Up button in 
PizzaDetailActivity’s action bar, MainActivity will 
be displayed: 

<activity 

android: name=" . PizzaDetailActivity" 

android: label=" @ string/ title_activity_pizza_detail " 

android :parentActivityName=" . MainActivity" > 

</activity> /Ha Wietivity is PizzaDetatfAdivit/s parent 

Once you’ve done that, we’ll look at how to get the recycler 
view to respond to clicks. 



□ 

BitsAndPizzas 




AndroidManifest.xml 
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The code for PizzaPetailActivity.java 

Here’s the full code for PizzaDetailActivity.java (don’t worry if it seems 
like a lot, this is all code that you’ve seen before): 



package com. hfad.bitsandpizzas ; 

import android . app . Activity ; 
import android . content . Intent ; 
import android . os . Bundle ; 
import android . view . Menu ; 
import android . view . Menul tern ; 
import android . widget . ImageView ; 
import android . widget . ShareActionProvider ; 
import android . widget . TextView ; 



□ 

Pizz 

■ 



BitsAndPizzas 



WeVe usin<^ these diasses. 



app/src/main 

HU 

java_ 

com. hfad.bitsandpizzas 

Lg 

PizzaDetailActivity.java 



public class Pi zzaDe tail Activity extends Activity { 



private ShareActionProvider ShareActionProvider ; 
public static final String EXTRA_PIZZANO = "pizzaNo" ; 

@ Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R. layout . activity_j?izza_detail) ; 



We II use this donstant to pass 
the ID ot the piz^a as extra 
intor nation in the intent- 



//Enable the Up button 

getActionBar () . setDisplayHomeAsUpEnabled (true) ; Enable the Up button- 



//Display details of the pizza 

int pizzaNo = (Integer) getlntent () .getExtras() . get (EXTRA_PIZZANO) ; 
String pizzaName = Pizza .pizzas [pizzaNo] . getName () ; 

TextView textView = (TextView) findViewByld (R. id. pizza_text) 
textView. setText (pizzaName) ; 

int pizzalmage = Pizza .pizzas [pizzaNo] . getlmageRe source Id () 

ImageView imageView = (ImageView) findViewByld (R. id. pizza_image) ; 
imageView. setlmageDrawable (getResources () .getDrawable (pizzalmage) ) ; 
imageView. setContentDescription (pizzaName) ; ^ 

Use the piz^a ID to populate 
the Te%t\Aew and ImageView. 



^ ^et the pizza 
the user dhose 
“Pror* the intent- 
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PizzaDetailActivity code 



The PizzaPetailActivity code (continued) 

@ Override 

public boolean onCreateOptionsMenu (Menu menu) { 



getMenuInf later ( ) . inflate (R . menu . menujnain , menu) ; 



Add items in the menu resource 
. -f ile to the action bar. 



//Share the name of the pizza 

TextView textView = (TextView) findViewByld (R. id. pizza_text) ; 

CharSequence pizzaName = textView. getText () ; 

Menultem menultem = menu. findl tern (R. id. action_share) ; 

shareActionProvider = (ShareActionProvider) menultem. getActionProvider () ; 
Intent intent = new Intent (Intent . ACTION_SEND) ; 
intent . setType ( " text/plain" ) ; 

intent . putExtr a (Intent .EXTRA_TEXT, pizzaName) 
shareActionProvider . setSharelntent (intent) ; 
return true ; ^ 



Set the de-fault text to 
share in the Share action. 



{ 



@ Override 

public boolean onOptions I temSelec ted (Menultem item) 
switch (item.getltemld() ) { 

case R . id . action_create_order : 

Intent intent = new Intent (this , OrderActivity. class) ; 
startActivity (intent) ; 
return true ; 
default: 

return super . onOptions I temSelec ted (item) ; 

} 



□ 

BitsAndPizzas 

1 m 

app/src/main 

>-c □ 

java_ 

43 

com.hfad.bitsan^pizzas 



a 

PizzaDetail 

Activity.java 



X 

Start OrderActivity 'when the 
user clicks on it in the action bar. 



Once you’ve updated your PizzaDetailActivity.java code, we’ll 
look at how to get the recycler view to respond to clicks. 
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(retting a RecyclerView to respond to clicks 

We need to get items in the recycler view to respond to clicks so 
that we can start PizzaDetailActivity when the user clicks 
on a particular pizza. 

When you create a navigation list with a list view, you can 
respond to click events within the list by giving the list view an 
OnltemClickListener. The list view listens to each of the 
views that it contains, and if any of them are clicked, the list view 
calls its OnltemClickListener. That means that you can 
respond to list item clicks with very little code. 

List views are able to do this because they inherit a bunch of 
functionality from a very deep hierarchy of superclasses. Recycler 
views, however, don’t have such a rich set of built-in methods, as 
they don’t inherit from the same superclasses: 




While this gives you more flexibility, it also means that with the 
recycler view you have to do a lot more of the work yourself. So 
how do we get the recycler view to respond to clicks? 
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listen to views 



You can listen to views from the adapter 

If you want your recycler view to respond to clicks, you need to write the 
code yourself In order to write event code, you need access to the views 
that appear inside the recycler view So where do you do that? 

The views are all created inside the CaptionedlmagesAdapter 
class. When a view appears on screen, the recycler view calls the 
onBindViewHolder ( ) code to make the card view match the details 
of the list item. 

Let’s say you want to send the user to an activity that displays a single 
pizza whenever a pizza card view is clicked. That means you could put 
some code inside the adapter to start an activity like this: 

class CaptionedlmagesAdapter extends RecyclerView. Adapter<CaptionedImagesAdapter . ViewHolder>{ 



public void onBindViewHolder (ViewHolder holder, int position)! 

CardView cardView = holder . cardView; 

ImageView imageView = (ImageView) cardView. findViewByld (R. id. inf o_image) ; 

Drawable drawable = cardView. getResources () .getDrawable (imagelds [position] ) ; 
imageView. setlmageDrawable (drawable) ; 

TextView textView = (TextView) cardView. findViewByld (R. id. inf o_text) ; 
textView. setText (captions [position] ) ; 

cardView . setOnClickLis tener (new View . OnClickListener ( ) { 

QOverride 

public void onClick (View v) { 

Intent intent = new Intent (container .getCon text () , Pi zzaDe tail Activity. class) 
intent .putExtra (PizzaDetailActivity .EXTRA_PIZZANO, position) ; 
container . getContext () . startActivity (intent) ; 

} ^ 

} ) '' /\ddr m oj -this toAt -to Captionedka^esAdaptev- 

} wl || start Piz*aPeU.IAttwity whe* a 

} Cav-dView is clicked- 



But just because you could write this code, doesn’t necessarily mean 
that you should. 










You could respond to a click event by adding code to your adapter class. Is 
there a reason why you wouldn’t want to do that? 



632 Chapter 14 



material design 



Keep your adapters reusable 

If you deal with click events in the CaptionedlmagesAdapter 
class, you’ll limit how that adapter can be used. Think about the app we’re 
building. We want to display lists of pizzas, pasta, and stores. In each 
case, we’ll probably want to display a list of captioned images. If we 
modify the CaptionedlmagesAdapter class so that clicks always 
send the user to an activity that displays details of a single pizza, we 
won’t be able to use the CaptionedlmagesAdapter for the pasta 
and stores lists. We’ll have to create a separate adapter for each one. 

decouple your adapter with an interface 

Instead, we’ll keep the code that starts the activity outside of the 
adapter. When someone clicks on an item in the list, we want the 
adapter to call the fragment that contains the list and the fragment 
code can then fire off an intent to the next activity. That way we 
can reuse CaptionedlmagesAdapter for the pizzas, pasta, and 
stores lists, and leave it to the fragments in each case to decide what 
happens in response to a click. 

We’re going to use a similar pattern to the one that allowed us to 
decouple a fragment from an activity. We’ll create a Listener 
interface inside CaptionedlmagesAdapter like this: 

public static interface Listener { 

public void onClick(int position) ; 

} 



We’ll call the Listener’s onClick ( ) method whenever one of the 
card views in the recycler view is clicked. We’ll then add code to 
PizzaMaterialFragment so that it implements the interface; 
this will allow the fragment to respond to clicks and start an activity. 



This is what will 

o 

o 

o 



happen at runtime: 

A user will click on a card view in the recycler view. 

The Listener’s onClick ( ) method will be called. 

The onClick ( ) method is implemented in PizzaMaterialFragment. 
Code in the fragment starts PizzaDetailActivity. 



Let’s start by adding code to CaptionedlmagesAdapter.java. 



you are here ► 
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Add the interface to the adapter 

We’ve updated our CaptionedlmagesAdapter.java code to add the Listener 
interface and call its onClick ( ) method whenever one of the card views is 
clicked (apply the changes to your code, then save your work): 



package com.hfad.bitsandpizzas; 

import android . graphics . drawable . Drawable ; 
import android . support . v7 . widget . RecyclerView; 
import android. view. Layoutlnf later; 

import android. view. View; ^ VVcVc us'mg -this e%*b-a Rlass, so imfovb »t 

import android. view. ViewGroup; 
import android . support . v7 . widget . CardView; 
import android . widget . ImageView; 
import android. widget . TextView; 



□ 

BitsAndPizzas 

43 

app/src/main 

H3 



java 



m3 



com.hfad.bitsandpizzas 



Captionedlmages 

Adapter.java 



class CaptionedlmagesAdapter extends RecyclerView. Adapter<CaptionedImagesAdapter . ViewHolder>{ 



private String [ ] captions; 
private int [ ] imagelds; 

private Listener listener; ^ — ftdd ‘the Lis-tcncv- as a priva”te variable- 

-This is -the m-temf a Re- 

public static interface Listener { 

public void onClick(int position); 

} 



public static class ViewHolder extends RecyclerView. ViewHolder{ 
private CardView cardView; 
public ViewHolder (CardView v) { 
super (v) ; 
cardView = v; 






lA/icVc no-t Rhanging -these methods. 



public CaptionedlmagesAdapter (String [ ] captions, int [ ] imagelds) { 
this . captions = captions; 
this . imagelds = imagelds; 

} 
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The CaptionedlmagesAdapter.java code (continued) 



public void setListener (Listener listener) { 
this . listener = listener;^ , A/4-iuiWs a* 



Activity's and tra<y».ents will use -this 
method to register as a listener. 



} 



@ Over ride 

public CaptionedlmagesAdapter . ViewHolder onCreateViewHolder (ViewGroup parent, int viewType) { 
CardView cv = (CardView) Layoutlnf later . from (parent . getContext () ) 



return new ViewHolder (cv) ; 

} 

public void onBindViewHolder (ViewHolder holder, final int position) { 

CardView cardView = holder . cardView; 

ImageView imageView = (ImageView) cardView. findViewByld (R. id. inf o_image) ; 
Drawable drawable = cardView. getResources () .getDrawable (imagelds [position] ) ; 
imageView. setlmageDrawable (drawable) ; 
imageView. setContentDescription (captions [position] ) ; 

TextView textView = (TextView) cardView. findViewByld (R. id. info_text) ; 
textView. setText (captions [position] ) ; 

cardView . setOnClickListener (new View . OnClickLis tener ( ) { 



. inf late (R. layout . card_captioned_image, parent, false); 



QOverride 

public void onClick (View v) { 




if (listener != null) { 



BitsAndPizzas 



listener . onClick (position) ; 



t 




} 



app/src/main 




}) ; 



> 



When the Cardl/iew is clicked, call 
the Listener onClickO method. 



com.hfad.bitsandpizzas 




@ Over ride 

public int getltemCount ( ) { 



Captionedlmages 

Adapter.java 



return captions . length; 



Now that we’ve added a Listener to the adapter, we’ll 
implement it in PizzaMateria IFragmen t.java . 



you are here ► 
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Implement the listener in 
PizzaMaterialFragment.java 



We’ll implement CaptionedlmagesAdapter’s Listener 
interface in PizzaMaterialFragment so that when a card 
view in the recycler view is clicked, Pi zzaDe tail Activity 
will be started. Here’s the code: 

package com.hfad.bitsandpizzas; 



public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 

RecyclerView pizzaRecycler = (RecyclerView) inf later . inf late ( 

R. layout . fragment_pizza_material, container, false); 

String [] pizzaNames = new String [Pizza . pizzas . length] ; 
for (int i = 0; i < pizzaNames . length; i++) { 





import android. os . Bundle; 

import android. support . v7 .widget . LinearLayoutManager ; 
import android . support . v7 . widget . RecyclerView; 
import android. view. Layoutlnf later ; 
import android. view. View; 
import android. view. ViewGroup; 



BitsAndPizzas 



app/src/main 





com.hfad.bitsandpizzas 




public class PizzaMaterialFragment extends Fragment { 



@ Over ride 



PizzaMaterial 

Fragment.java 





pizzaNames [ i ] = Pizza. pizzas [i] .getName () ; 




This todc stays the same- 



int [ ] pizzalmages = new int [Pizza .pizzas . length] ; 
for (int i = 0; i < pizzalmages . length; i++) { 



pizzalmages [i] = Pizza. pizzas [i] .getlmageResourceld ( ) ; 



636 Chapter 14 



material design 



The PizzaMaterialFragment.java code (continued) 

CaptionedlmagesAdapter adapter = new CaptionedlmagesAdapter (pizzaNames, pizzalmages) 
pizzaRecycler . setAdapter (adapter) ; 

LinearLayoutManager layoutManager = new LinearLayoutManager (getActivity ( ) ) ; 
pizzaRecycler . setLayoutManager (layoutManager) ; 



adapter . setListener (new CaptionedlmagesAdapter . Listener ( ) { 
public void onClick(int position) { 

Intent intent = new Intent (getActivity () , PizzaDetailActivity .class) ; 



intent .putExtra (PizzaDetailActivity .EXTRA_PIZZANO, position) ; 



getActivity () . star tActivity (intent) ; 



} 

}); 

return pizzaRecycler; 

} 

} 



This iw^lewen-b the L-iste*ev 
oftClitkO method It starts 
Pizjz^aPc-ta.IAt-twi-ty, passi^ it the 
|p Jr the piz*a the user those- 



That’s all the code we need to make views in the recycler view 
respond to clicks. By taking this approach, we can use the same 
adapter and card view for different types of data that is composed 
of an image view and text view 



□ 

Bits And Pizzas 

4U 

app/src/main 

4U 



java_ 

m3 

com. hfad.bitsand pizzas 




PizzaMaterial 

Fragment.java 




you are here ► 
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Test drive the app 



Run the app, open the navigation drawer, and click on 
the Pizzas option. A list of card views is displayed, each 
one showing a different pizza, as before. Let’s see what 
happens when you click on one of the pizzas: 



<- Bits And Pizzas 



Home 



Pizzas 

Pasta 

Stores 



Men you t liek on 
-the pizzas option, 
pizzaMatev-ialPva^ent 
is displayed- 






J + : 



h 





1 


* 


V A □ 13:38 1 


| = Pizzas 


\ 



Men you eliek on 
a piz^a, its details 
are displayed in 
PiziaDctailA^tivity- 





<1 


° 1 


\ \ 




The card view responds to the click, and displays 
Pi zzaDe tail Activity. 

There’s just one more thing we need to look at: the content 
we need to include in Top Fragment. 
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Pring the content forward 



When we first looked at the design of the Pizza app, Top Fragment 
contained a list of navigation options. We moved these away 
from Top Fragment using a combination of an action bar and 
navigation drawer, leaving Top Fragment empty. So what should 
Top Fragment contain? 

Top Fragment is our top-level screen, so it’s the first screen that 
your users see when they start the app. Your top-level screen should 
be rewarding for both new and regular users, and one way you can 
do this is by bringing the content forward. 

If you look at some of the Google apps on your device, there’s 
one thing they have in common: they allow you to get to the main 
content of the app quickly by bringing some of it forward onto the 
top-level screen. The Calendar app displays upcoming events. Apps 
such as Play Books and Play Music display your recent actions and 
recommendations. They form the centerpiece of the top-level screen. 





0 ^ a U 11*-4 


! 0 W A 0 1 1 a c 


= Read now 


a : 


= March - g| : 



The Play Books 
app displays books 
you've recently 
downloaded, and 

recommendations 
-for other books 
you may enjoy. 




The Calendar 
app displays 
upcoming events 
so theyVe easy 
to get to- 



We can bring the content forward in our Pizza app by displaying 
some of the food that’s available in Top Fragment. The good news 
is that you can do this with very little effort using the skills you’ve 
already learned in this chapter. 



you are here ► 
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exercise 




You’re going to change TopFragment so that it displays introductory text and a recycler view 
that displays pizzas. First, write the layout code for fragment_top.xml You need TopFragment 
to look like the image below. 



This is what you want 
TopFVa<y*ent to look like. 
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Next, add code to the box below to finish writing the code for 
TopFragment.java so that the recycler view is populated with two 
pizzas in a grid layout. If the user clicks on one of the pizzas, 
display its details in PizzaDetailActivity.java. 



public class TopFragment extends Fragment { 



QOverride 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 

RelativeLayout layout = (RelativeLayout ) 

inf later . inf late (R . layout . fragment_top, container, false) 



tVrite 

you\r 

tode 

here. 



CaptionedlmagesAdapter adapter = 

new CaptionedlmagesAdapter (pizzaNames, pizzalmages); 
pi zzaRe cycler . setAdapter (adapter) ; 

adapter . setListener (new CaptionedlmagesAdapter . Listener ( ) { 

public void onClick(int position) { 

Intent intent = new Intent (getActivity () , PizzaDetailActivity . class ) ; 
intent . putExtra (PizzaDetailActivity . EXTRA_PIZZANO, position) ; 
getActivity ( ) . startActivity (intent) ; 

i t 

} ) ; Most of the £ode is the same as -for 

return layout; P'^/WaterialFrajmehtjava. 



} 



you are here ► 
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IjitlOH 



You’re going to change TopFragment so that it displays introductory text and a recycler view 
that displays pizzas. First, write the layout code for fragment_top.xml You need TopFragment 
to look like the image below. 





Q Wj U 11:52 


= Bits And Pizzas 


s + i 


We offer a range of freshly baked pizza and pasta 1 


| dishes. Why not try some? 






Do* t worry i-f your toAt looks di^erent to ours. There are 
^ - ma*y different ways o-f £reatm3 a similar looking layout 

<RelativeLayout %ml*s.a*droid— w http*/ / sdhemas.androiddom/ apk/ res/ a*droid ,; 
y.ml*s:*bools=* w k*t*tp : / / s^hemas-android-dom/ tools” 

a*droid:layou*t_^^/id^^>==■ >, ma^dk_fare*t , 
a*droid : layout_hei3ht— w r*atdh__pare*t w 
a*droid:paddi*37op— ^1 tdp” 
ahdroidfaddi^BotW—’l Mp” 
a*droid : paddi*3Ri3ht— 7 tdp” 
a^droid^addm^Le-f *t= lW l tdp” 
t>ols:do*te%t— w -A1a'mA^‘t» v »‘ty w > 

.^This is -for the 

<Te*l\/iew ^ mbrod»<.Wy twt 

a*droid;layout_width— ”matdh_pare*t” 
a*droid : layout_hei3ht :::1 ”wrap__do*te*t , 
a *dr oi d : te^t— ” @stri *3/ weldome__te*t” 
a*droid : id— ”@+id/weldome_te%t w /> 

This is -for the 
redydler view. 

<a*droidsupportv7wid3etRedydler\/iew 
a * dr oi d ; i d @ +i d/pi z^a__r e dy d I er ” 
a*droid : sdrollbars=-”vertidal” 
a*droid : layout_width— ^maidh^pareKt* 
a*dr oi d : layout__hei3h t—” wrap__ do^te^t* 
a*droid : layout__ below—^^+id/ weldome__te*t” 
a*droid:layou*t_mar3i*7op— , l Odp V > 

</RelativeLayout> 



Diavolo 



Funghi 
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en your pencil 
Solution 



Next, add code to the box below to finish writing the code for 
TopFragment.java so that the recycler view is populated with two 
pizzas in a grid layout. If the user clicks on one of the pizzas, 
display its details in PizzaDetailActivity.java. 



public class TopFragment extends Fragment { 



@Override 

public View onCreateView (Layoutlnf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 

RelativeLayout layout = (RelativeLayout ) 

inf later . inf late (R. layout . fragment_top, container, false); 



YouV* Code 
may look 

different 



RedydlevView pizzaRedydlev =■ (RedydlevView)layoutfir\d\/ie>wByld(R.id.pizza_redydle\r); 
£-brm^£J piz zaNames =■ new Strict 2-3; 
for Omt i — 0; i < Zj i++) { 

pizzaNamesCi3 =■ PizzapizzasCd.^etNameO; 

} ^ 

’mtC3 pizzalmays =■ new mtC2J; ^ ^ vVcMI display two pizzas. 

-fo\r (irrt i — Oj i < Z\ i++) { 

pizza |magesCi3 =■ PizzapizzasW^etlmageResouv-deldO; 

} V^T ^ is P la y pizzas \n a two-dolumn yr\d. 

^vidLayout/klahagcv- layoutMdr^dv* =• new ^ridLayoutMa*a9dv-(3etAdtivityO,2.); 
pizzaRcdydlcv-.sc*tLayou*t/klar\a3crOayou*t/klar\a3cr); 



CaptionedlmagesAdapter adapter = 

new CaptionedlmagesAdapter (pizzaNames, pizzalmages) , 
pi zzaRe cycler . set Adapter (adapter) ; 

adapter . setListener (new CaptionedlmagesAdapter . Listener ( ) { 

public void onClick(int position) { 

Intent intent = new Intent (getActivity () , PizzaDetailActivity . class ) , 
intent . putExtra (PizzaDetailActivity . EXTRA_PIZZANO, position) ; 
getActivity ( ) . startActivity ( intent ) ; 



}) ; 

return layout; 



Most of the Code is the same as ft 

Pizz^MateHalFv-agmehtjava. 



} 



you are here ► 
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The full code for fragment_top.xml 

We’ve changed Top Fragment so that it displays introductory text 
and two pizzas. We ’ll show you the full code over the next couple of 
pages. 

First, add the following to strings, xml: 

<string name= M welcome_text M >We offer a range of freshly baked pizza and pasta 
dishes. Why not try some?</string> 

Then update fragment_top.xml with the following code: 



<RelativeLayout xmlns : android= M http : //schemas . android . com/apk/ res /android" 
xmlns : tools="http : //schemas . android.com/tools" 
android : layout_width="match_j?arent" 
android : layout_height="match_jparent" 
android : paddingTop=" 1 6dp" 



□ 



android : paddingBottom=" 16dp" 
android : paddingRight= " 1 6dp " 
android : paddingLef t=" 16dp" 
tools : context=" .MainActivity"> 



BitsAndPizzas 



4B 

app/src/main 

Hn 



LQ 

layout 



fragment_top.xml 



<TextView 

android : layout_width="match_j?arent" 
android : layout_height="wrap_content" 
android: text="@string/welcome_text" 

android: id="@+id/ welcome text" /> . , 

\ WieVe adding a \l\tv a*a 

Re^ydevVicv/ -to layout 

<android . support . v7 . widget . RecyclerView 
android: id="@+id/pizza_recycler" 
android: scrollbars=" vertical" 
android : layout_width="match_j?arent" 
android : layout_height="wrap_content " 
android : layout_below=" @+id/welcome_text" 
android : layout_marginTop=" 10 dp" /> 

</RelativeLayout> 



On the next page, we’ll show you the code for TopFragment.java. 
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The full code for TopFragment.java 

package com . hf ad . bitsandpizzas ; 



import android . content . Intent ; 
import android . os . Bundle ; 
import android . app . Fragment ; 

import android . support . v7 . widget . GridLayoutManager ; 
import android . support . v7 . widget . RecyclerView ; 
import android . view . Layout Inf later ; 
import android . view . View ; 
import android . view . ViewGroup ; / WcVe usm^ these diasses 

import android . widget . RelativeLayout ; 

public class TopFragment extends Fragment { 



□ 

BitsAndPizzas 

HT3 

app/src/main 

java_ 

Ma 

com. hfad. bitsandpizzas 

L@ 

TopFragment.java 



@Override 

public View onCreateView (Layout Inf later inf later, ViewGroup container. 

Bundle savedlnstanceState) { 

RelativeLayout layout = (RelativeLayout) 

inf later . inflate (R . layout . f ragmen t_top , container , false) ; 
RecyclerView pizzaRecycler = (RecyclerView) layout. findViewById(R. id. pizza_recycler) ; 
String [] pizzaNames = new String [2] ; 
for (int i = 0; i < 2; i++) { 

pizzaNames [i] = Pizza. pizzas [i] . getName () ; 

} 'V 

int [] pizzalmages = new int [2] ; Create arrays -for the piz 



P |2 ^3 har*es ahd im, 



for (int i = 0; i < 2; i++) { 

pizzalmages [i] = Pizza. pizzas [i] .getImageResourceId() ; 
j ^ Display the pizzas m a <yrid- 

GridLayoutManager layoutManager = new GridLayoutManager (getActivity () ,2) ; 
pizzaRecycler . setLayoutManager (layoutManager) ; 

Cap tionedlmages Adapter adapter = new Cap tionedlmagesAdap ter (pizzaNames , pizzalmages) 
pizzaRecycler . setAdapter (adapter) ; ^ 

adapter . setListener (new Cap tionedlmagesAdap ter . Listener ( ) { 
public void onClick(int position) { 

Intent intent = new Intent (getActivity () , PizzaDetailActivity. class) ; 
intent . putExtra (PizzaDetailActivity . EXTRA_PIZZANO , position) ; 
getActivity () . star tActivity (intent) ; 

> ^ 

} ) ; pizzaPetailActWity when the user tkb on a 

return layout; 



Use -the adapter to 
display the pizzas. 



pizza, passing it the position of the pizza- 
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another test drive 

Vc^oH.^ -O* 

Test drive the app 

Let’s see what happens when you run the app. 





Funghi 



Two pizzas ave displayed 
in a yid- When you tiitk 
on a pizza, its details ave 
displayed 



(S> # A U 11:52 



= Bits And Pizzas 



We offer a range of freshly baked pizza and pasta 
dishes. Why not try some? 



Top Fragment is displayed, showing some introductory 
text and two of the pizzas. When you click on a pizza, its 
details are displayed in PizzaDetailActivity. 
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Your Android Toolbox 



You’ve got Chapter 14 under 
your belt and now you’ve 
added Material Design to your 
box. 



You tan download 
-the -full tode -fov 
the thaftev- £v-om 
https : //-t'nyuV-Uom/ 
Headf" iv-stAndvoid- 




BULLET POINTS 



■ Card views and recycler views have their 
own support libraries. 



■ Add a card view to a layout using 

the <android. support . 

v7 . widget . CardView> element. 

■ Give the card view rounded corners using 

the cardCornerRadius attribute. 
This requires a namespace of "http : // 

schemas . android. com/apk/ 
res-auto". 

■ Recycler views work with adapters that 
are subclasses of RecyclerView . 
Adapter. 

■ When you create your own 

RecyclerView . Adapter, you must 
define the viewHolder and implement 

the onCreateViewHolder ( ) , 
onBindViewHolder ( ) , and 
getltemCount ( ) methods. 



You add a recycler view to a layout 
using the <android . support . 
v7 . widget . RecyclerView> 
element. You give it a scrollbar using the 

android: scrollbars attribute. 

Use a layout manager to specify how 
items in a recycler view should be 
arranged. A LinearLayoutManager 
arranges items in a linear list, 
a GridLayoutManager 
arranges items in a grid, and a 
St agger edGridLayoutManager 
arranges items in a staggered grid. 



you are here ► 
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have fun 



Leaving town... 




It's been great having you here in Androidville 

We’re sad to see you leave, but there’s nothing like taking what you’ve learned 
and putting it to use. There are still a few more gems for you in the back of the book and 
an index to read through, and then it’s time to take all these new ideas and put them into 
practice. Bon voyage! 
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appendix i: art 



^ The Android Runtime + 




Android apps need to run on devices with low-powered 
processors and very little memory. 

Java apps can take up a lot of memory, and because they run inside their own Java Virtual 
Machine (JVM), Java apps can take a long time to start when they’re running on low- 
powered machines. Android deals with this by not using the JVM for its apps. Instead, it 
uses a very different virtual machine called the Android runtime (ART). In this appendix, 
we’ll look at how ART gets your Java apps to run well on a small, low-powered device. 



this is an appendix 



649 



ART vs JVM 



What is the Android runtime (ART)? 

The Android runtime (ART) is the system that runs your compiled code on 
an Android device. It first appeared on Android with the release of KitKat 
and became the standard way of running code in Lollipop. 

ART is designed to run your compiled Android apps quickly and efficiently 
on small, low-powered devices. 

ART is very different from the JVM 

Java has been around for a very long time, and compiled Java programs 
have almost always run on Oracle’s Java Virtual Machine JVM). The 
JVM simulates a GPU chip, and it reads a compiled . class file that contains 
JVM machine code instructions called bytecodes. Traditionally you would 
compile .java source files into . class files. You would then run these using the 
JVM interpreter. 



Java sou\r£e is 



Compiled iivfco 
•dass -Piles. 




ART is very different. When you compile an Android application, 
everything starts in the same way. You write .java source files and compile 
them into . class files, but then a tool called dx will convert the set of . class 
(or .jar archives) into a single file called classes.dex. 




The build process 
s-ti-fcehes all -the dass 
-Piles irrfco a single 
dasses.de* -Pile- 



This classes, dex file also contains bytecodes, but they are different from the 
bytecodes in a . class file. The .dex bytecodes are for a completely different 
virtual processor called Dalvik. In fact, dex stands for Dalvik Executable. 

The Dalvik processor is kind of similar to the JVM. Both the JVM and 
Dalvik are virtual processors. They are both theoretical chips. But the 
Oracle JVM is a stack-based processor and Dalvik is a register-based 
processor. Some people believe that code for register-based processors 
can be tuned to be smaller and to run faster. By converting a whole set 
of different files into a single classes, dex file, the dx tool is able to make 
the compiled app a lot smaller because it can remove a lot of duplicated 
symbols that might appear in many . class files. 
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The classes, dex file is then compressed with a bunch of other resource 
and data files into a ZIP-compressed file called an application 
package or APK file. The .apk file is the final compiled application 
that can be installed on an Android device. This is the file that you’ll 
eventually upload to the Google Play Store. 



A* app is 

Seated -(Vor* 
.java 

source -Piles. 
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How Android runs an APK file 

The APK file is just a ZIP-compressed archive. When it’s transferred 
to an Android device, it’s stored in a directory called /data/ 
app/<package name> and then the classes. dex file is extracted from it. 

When the classes.dex file is extracted from the APK archive, it’s 
converted into a native library. The Dalvik bytecodes become actual 
native machine code instructions that can be run directly by the 
device’s GPU. This compiled library is then stored in the /data/dalvik- 
cache directory. Android only needs to perform this native compilation 
step the first time that the app is run. From then on, the Android 
device can simply load and run the native library. 



Android is just a version of the Linux operating system, 
and Linux doesn’t normally have the ability to run 
Android apps. That’s why each Android device runs a 
process called Zygote. Zygote is like an Android process 
that is already up and running. When you tell Android 
to start a new Android app, Zygote will create a forked 
version of itself. A forked process is just another copy of 
the process in memory. Linux can fork processes very 
quickly, so by forking the Zygote process and then loading 
the native library, an Android app can be loaded very 
quickly. 




-fvor* i\\t Z-y $oic pvodess. 

you are here ► 



651 






performance 



Performance and size 

Android devices usually have a lot less power and storage than 
machines that normally run Java code. ART uses .dex files that 
are normally smaller than their equivalent . class files. The Oracle 
JVM can compile some parts of the code it interprets using just- 
in-time compilation, which means that the JVM converts Java 
bytecode into machine code while it’s running the code. This is 
fine for applications that run for a very long time, like application 
servers, but Android applications might be started and stopped 
regularly. By compiling all of the Dalvik bytecodes into a native 
library ahead of time, ART ensures that it only needs to compile 
the code once. 

Finally, the Oracle Java runtime can take some time to start on 
low-powered devices. By using the Zygote process, Android is 
able to get apps up and running much more quickly. The Zygote 
process can also use shared memory to securely execute code that 
will be common to all Dalvik processes. 

Security 

An Android device might run code from many different 
developers, and it’s important that each app is completely isolated 
from every other app. Without that separation, one app might 
breach the security of any other app on the device. To ensure that 
apps are isolated, Android will run each app in a separate process, 
with an automatically generated user account. This allows apps 
to be isolated using operating system security provided by Linux. 
If the Oracle Java runtime was used, each process would require 
its own Java process, which would greatly increase the memory 
required to run several apps. 
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^ The Android Debug Bridge ^ 



What better gift 
for the girl who has 
everything than a new 
command-line tool? 



In this book, we’ve focused on using an IDE for all your 

Android needs. But there are times when using a command-line tool can be plain 
useful, like those times when Android Studio can’t see your Android device but you just 
know it’s there. In this chapter, we’ll introduce you to the Android Debug Bridge (or adb), 
a command-line tool you can use to communicate with the emulator or Android devices. 
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adb: your command-line pal 

Every time your development machine needs to talk to an Android device, 
whether it’s a real device connected with a USB cable, or a virtual device 
running in an emulator, it does it by using the Android Debug Bridge 
(adb). The adb is a process that’s controlled by a command that’s also called 
adb. 

The adb command is stored in the platform- too Is directory of the 
Android System Developer’s Kit. On a Mac, you’ll probably find it in 
/Users /<username> /Library / 'Android/ 'sdk/platform- tools . If you add the platform- 
tools directory to your PATH, you will be able to run adb from the command 
line. 

In a terminal or at a command prompt, you can use it like this: 



1 Interactive Session 


$ adb devices 




List of devices 


attached 


emulator- 5554 


device 


$ 





The adb devices command means “Tell me which Android devices you 
are connected to”. The adb command works by talking to an adb server 
process, which runs in the background. The adb server is sometimes called 
the adb damon or adbd. When you enter an adb command in a terminal, a 
request is sent to network port 5037 on your machine. The adbd listens for 
commands to come in on this port. When Android Studio wants to run an 
app, or check the log output, or do anything else that involves talking to an 
Android device, it will do it via command port 5037. 




Device 



When the adbd receives a command, it will forward it to a separate adbd 
process that’s running in the relevant Android device. This will then be able 
to make changes to the Android device or return the requested information. 
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Sometimes, if the adb server isn’t running, the adb command will 
need to start it: 



Interactive Session 



$ adb devices 

* daemon not running, starting it now on port 5037 * 

* daemon started successfully * 

List of devices attached 
emulator-5554 device 

$ 



Likewise, if ever you plug in an Android device and Android 
Studio can’t see it, you can manually kill the adb server and restart 
it: 



Interactive Session 



$ adb devices 
List of devices attached 
$ adb kill- server 
$ adb start- server 

* daemon not running, starting it now on port 5037 * 

* daemon started successfully * 

$ adb devices 

List of devices attached 
emulator-5554 device 

$ 



By killing and restarting the server, you force adb to get back in 
touch with any connected Android devices. 
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Running a shell 

Most of the time you won’t use adb directly; you’ll let an IDE like 
Android Studio do the work for you. But there are times when it can be 
useful to go to the command line and interact with your devices directly 

One example is if you want to run a shell on your device: 

| Interactive Session | 



$ adb shell 
root@generic_x86 : / # 



The adb shell command will open up an interactive shell directly on 
the Android device. The adb shell command will only work when 
there is a single Android device connected, otherwise it won’t know 
which Android device you want to talk to. 

Once you open a shell to your device, you can run a lot of the standard 
Linux commands: 



Interactive Session 



$ adb shell 

root@generic_x86 : / # Is 

acct 

cache 

charger 

config 

d 

data 

default .prop 

dev 

etc 

file contexts 



1 | rootQgeneric x86:/ 


# df 








Filesystem 


Size 


Used 


Free 


Blksize 


/dev 


439. 8M 


60. OK 


439. 8M 


4096 


/mnt/asec 


439. 8M 


0 . OK 


439. 8M 


4096 


/mnt/obb 


439. 8M 


0 . OK 


439. 8M 


4096 


/system 


738. 2M 


533. OM 


205. 2M 


4096 


/data 


541. 3M 


237. 8M 


303. 5M 


4096 


/cache 


65. OM 


4.3M 


60. 6M 


4096 


/mnt/media rw/sdcard 


196. 9M 


4.5K 


196. 9M 


512 


/ s torage / sdcard 


196. 9M 


4.5K 


196. 9M 


512 



root@generic_x86 : / # 
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fret the output from logcat 

All of the apps running on your Android device sending their 
output to a central stream called the logcat. You can see the live 
output from the logcat by running the adb logcat command: 

| Interactive Session | 



$ adb logcat 

beginning of system 

I/Vold ( 936) : Void 2.1 (the revenge) firing up 

D/Vold ( 936) : Volume sdcard state changing -1 

(Initializing) -> 0 (No-Media) 

W/DirectVolume ( 936) : Deprecated implied prefix pattern 

detected, please use V devices/platform/ goldfish_mmc . 0*' 
instead 



The logcat output will keep streaming until you stop it. It can be 
useful to run adb logcat if you want to store the output in a 
file. The adb logcat command is used by Android Studio to 
produce the output you see in the Devices/logcat frame. 

Copying files to/from your device 

The adb pull and adb push commands can be used to 
transfer files back and forth. For example, here we are copying the 
/default.prop/ properties file into a local file called l.txt: 



Interactive Session 



$ adb pull /default.prop l.txt 
28 KB/s (281 bytes in 0.009s) 

$ cat 1 . txt 

# 

# ADDITIONAL DEFAULT PROPERTIES 

# 

ro . secure=0 

ro . allow . mock . location=l 
ro . debuggable=l 
ro . zygote=zygote32 
dalvik . vm . dex2oat-Xms=64m 
dalvik . vm . dex2oat-Xmx=512m 
dalvik . vm . image-dex2oat-Xms=64m 
dalvik . vm . image-dex2oat-Xmx=64m 
ro . dalvik . vm . native . bridge=0 
persist . sys . usb . conf ig=adb 
$ 
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And much, much more... 

There are many, many commands that you can run using adb: you 
can back up and restore databases (very useful if you need to debug 
a problem with a database app), start the adb server on a different 
port, reboot machines, or just find out a lot of information about 
the running devices. To find out all the options available, just type 
adb on the command line: 



Interactive Session 



$ adb 

Android Debug Bridge version 1.0.32 

. -a _ - directs adb to listen on all 

interfaces for a connection 

- directs command to the only 
returns an error if more than 

- directs command to the only 



connected USB device 

one USB device is present. 

-e 

running emulator, 
returns an error if more than one emulator is 
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^ The Android Emulator + 




Ever felt like you were spending all your time waiting for the 
emulator? 

There’s no doubt that using the Android emulator is useful. It allows you to see how your 
app will run on devices other than the physical ones you have access to. But at times it 
can feel a little... sluggish. In this appendix, we’re going to explain why the emulator can 
seem slow. Even better, we’ll give you a few tips we’ve learned for speeding it up. 
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Why the emulator is so slow 

When you’re writing Android apps, you’ll spend a lot of 
time waiting for the Android emulator to start up or deploy 
your code. Why is that? Why is the Android emulator so 
sloooooow? If you’ve ever written iPhone code, you will 
know how fast the iPhone simulator is. If it’s possible for the 
iPhone, then why not for Android? 

There’s a clue in the name: the iPhone Simulator and the 
Android Emulator. 

The iPhone Simulator simulates a device running the iOS 
operating system. All of the code for iOS is compiled to run 
natively on the Mac and the iPhone Simulator runs at Mac- 
native speed. That means it can simulate an iPhone boot-up 
in just a few seconds. 

The Android Emulator works in a completely different way. 
An Android Emulator uses an open source application called 
QEMU (or Quick Emulator) to emulate the entire Android 
hardware device. It runs code that interprets machine 
code that’s intended to be run by the device’s processor. It 
has code that emulates the storage system, the screen, and 
pretty much every other piece of physical equipment on an 
Android device. 



AVD 



AVD 



AVD 



AVD 



AVD 



QEMU Emulator 



/\|| the Android Virtual Pevides run 
on 3ft cmula*tov tailed $EMU. 



An emulator like QEMU creates a much more realistic 
representation of a virtual device than something like the 
iPhone Simulator does, but the downside is that it has to do 
far more work for even simple operations like reading disk or 
displaying something on a screen. That’s why the emulator 
takes so long to boot up a device. It has to pretend to be 
every little hardware component inside the device, and it has 
to interpret every single instruction. 
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How to speed up your Android development 

1. Use a real device 

The simplest way to speed up your development process is by using a real 
device. A real device will boot up much faster than an emulated one, and 
it will probably deploy and run apps a lot more quickly If you want to 
develop on a real device, you may want to go into “Developer options” 
and check the Stay Awake option. This will prevent your device locking 
the screen, which is useful if you are repeatedly deploying to it. 

Z. Use an emulator snapshot 

Booting up is one of the slowest things the emulator does. If you save 
a snapshot of the device while it’s running, the emulator will be able to 
reset itself to this state without having to go through the boot-up process. 

To use a snapshot with your device, open the AVD manager from the 
Android Studio menu by selecting Tools— > Android— ► AVD Manager, edit 
the AVD by clicking on the Edit symbol, then check the “Store a snapshot 
for faster startup” option. 

This will save a snapshot of what the memory looks like when the device 
is running. The emulator will be able to restore the memory in this state 
without booting the device. 

3. Use hardware acceleration 

By default, the QEMU emulator will have to interpret each machine 
code instruction on the virtual device. That means it’s very flexible 
because it can pretend to be lots of different GPUs, but it’s one of the 
main reasons why the emulator is slow. Fortunately, there’s a way to get 
your development machine to run the machine code instructions directly. 

There are two main types of Android Virtual Device: ARM machines and 
x86 machines. If you create an x86 Android device and your development 
machine is using a particular type of Intel x86 GPU, then you can 
configure your emulator to run the Android machine code instructions 
directly on your Intel GPU. 

You will need to install Intel’s Hardware Accelerated Execution Manager * 

(HAXM). At the time of writing , you can find HAXM here: 4 : — ' ^ S moV ^ * * , , 

v ; s y f^uidc should 

https:/ / software, intel. com/ en-us/ android/ articles /intel-hardware- •b-atk ft down. 

accelerated-execution-manager 

HAXM is a hypervisor. That means it can switch your GPU into a special 
mode to run virtual machine instructions directly. HAXM will only run 
on Intel processors that support Intel Virtualization Technology. If your 
development machine is compatible, then HAXM will make your AVD 
run much faster. 
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^ The Top Ten Things ♦ 
(we didn’t cover) 






Even after all that, there’s still a little more. 

There are just a few more things we think you need to know. We wouldn’t feel right about 
ignoring them, and we really wanted to give you a book you’d be able to lift without 
extensive training at the local gym. Before you put down the book, read through these 
tidbits. 
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1. distributing your app 

Once you’ve developed your app, you’ll probably want to make it 
available to other users. You’ll usually want to do this by releasing 
your app through an app marketplace such as Google Play 

There are two stages to this: preparing your app for release, and then 
releasing it. 



Preparing your app for release 

Before you can release your app, you need to configure, build, and 
test a release version of your app. This includes tasks such as deciding 
on an icon for your app and modifying AndroidManifest. xml so that 
only devices that are able to run your app are able to download it. 

Before you release your app, make sure that you test it on at least one 
tablet and one phone to check that it looks the way you expect and its 
performance is acceptable. 

You can find further details of how to prepare your app for release 
here: 

http:/ / developer, android, com/ tools /publishing/preparing, html 

Releasing your app 

This stage includes publicizing your app, selling it, and distributing it. 

To release your app on the Play Store, you need to register for a 
publisher account and use the Developer Console to publish your 
app. You can find further details here: 

http:/ / developer, android, com/ distribute/googleplay/ start, html 

For ideas on how to best target your app to your users and build a 
buzz about it, we suggest you explore the documents here: 

http:/ / developer, android, com/ distribute /index, html 
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1 . Content providers 

You’ve seen how to use intents to start activities in other apps. As 
an example, you can start the Messaging app to send the text you 
pass to it. But what if you want to use another app’s data in your 
own app? What if you want to use Contacts data in your app to 
perform some task, or insert a new Calendar event? 

You can’t access another app’s data by interrogating its database, 
Instead, you use a content provider. A content provider is an 
interface that allows apps to share data in a controlled way. It 
allows you to perform queries to read the data, insert new records, 
and update or delete existing records. 




Provider 



If you want other apps to use your data, you can create your own 
content provider. 

You can find out more about the concept of content providers 
here: 

http:/ / developer, android, com/guide/ topics /providers/ content- 
providers.html 

Here’s a guide on using Contacts data in your app: 

http:/ / developer, android, com/guide/ topics /providers/ contacts- 
provider.html 

Here’s a guide on using Calendar data: 

http:/ / developer, android, com/guide/ topics /providers/ 
calendar-provider, html 
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3 . The WebView class 

If you want to provide your users with access to web content, you 
have two options. The first option is to develop a web app that 
users can access on their device using a browser. The second option 
is to use the WebView class. 

The WebView class allows you to display the contents of a web 
page inside your activity’s layout. You can use it to deliver an entire 
web app as a client application, or to deliver individual web pages. 
This approach is useful if there’s content in your app you might 
need to update, such as an end-user agreement or user guide. 

You add a WebView to your app by including it in your layout like 
this: 



<WebView xmlns : android="http : // schemas . android. com/ apk/ res/ android" 
android: id=" @+id/webview" 
android : layout_width="match_parent" 
android: layout_height="match_parent" /> 

You tell it which web page to load using the loadUrl ( ) method 
in your Java code like this: 

WebView webView = (WebView) findViewByld (R. id. webview) ; 
webView . loadUrl ( "http : / / www . oreilly . com/ " ) ; 

You also need to specify that the app must have Internet access by 
adding the INTERNET permission to AndroidManifest. xml: 

<manifest ... > 

<uses -permission android : name=" android . permission . INTERNET" /> 



</manifest> 

You can find out more about using web content in your apps here: 

http:/ / developer, android, com/guide/ web apps /index, html 
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4. Animation 

As Android devices use more of the power from their built-in graphics 
hardware, animation is being used more and more to improve the 
user’s app experience. 

There are several types of animation that you can perform in Android: 

Property animation 

Property animation relies on the fact that the visual components 
in an Android app use a lot of numeric properties to describe their 
appearance. If you change the value of a property like the height or 
the width of a view, you can make it animate. That's what property 
animation is: smoothly animating the properties of visual components 
over time. 



View animations 

A lot of animations can be created declaratively as XML resources. 

So you can have XML files that use a standard set of animations (like 
scaling, translation, and rotation) to create effects that you can call from 
your code. The wonderful thing about declarative view animations is 
that they are decoupled from your Java code, so they are very easy to 
port from one app project to another. 



Activity transitions 



Let's say you write an app that displays a list of items with 
names and images. You click on an item and you’re taken 
to a detail view of it. The activity that shows you more 
detail will probably use the same image that appeared in 
the previous list activity. 

Activity transitions allow you to animate view from one 
activity that will also appear in the next activity. So you 
can make an image from a list smoothly animate across 
the screen to the position it takes in the next activity. This 
will give your app a more seamless feel. 

To learn more about Android animation see: 

https:/ / developer, android, com/guide/ topics /graphics/ 
index.html 

To learn about activity transitions and Material Design, see: 




https:/ / developer, android, com/ training/ material/ 
animations.html 
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5. Maps 

An Android device can go everywhere with you, and so location 
and mapping are important features in many Google apps. 

If you install the Google Play Services library, you can embed 
Google Maps directly into your app. It comes with the full 
power of the native app, plus you can do a huge amount of 
customization to make maps a fully integrated part of your app. 

You insert a map into a layout as a fragment: 

<f ragment xmlns : android= M http : / / schemas . android . com/ apk/ res/ android" 
android: id="@+id/map" 
android: layout_width="match_parent " 
android : layout_height="match_parent " 
android: name="com. google . android. gms .maps .MapFragment"/> 



Then you can programmatically access the map from your code 
as a GoogleMap object: 



GoogleMap map = getMap ( ) ; 

And then you add your own features to the map. For example, 
you add polylines to it like this: 

routeLine = map . addPolyline (new PolylineOptions ( ) 
.width (ROUTE_THICKNESS_PIXELS ) 

. color (Color . RED) ) ; 



This is ah app that has 6\ oogle 
Maps embedded ih it. 



This is a polylme. 
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5. Maps (continued) 

You can also listen to events on the app. With an 
OnCameraChangeListener you can see when the 
user moves the map to a different location, and with an 
OnMapClickListener you can tell the latitude and 
longitude of the point on the map where a user just clicked: 

map . setOnCameraChangeListener (new OnCameraChangeListener ( ) { 

QOverride 

public void onCameraChange (CameraPosition cameraPosition) { 
/ / Dragged to a new place on the map 



}) ; 

map . setOnMapClickListener (new OnMapClickListener ( ) { 

QOverride 

public void onMapClick (LatLng latLng) { 

// Clicked at a latitude/longitude latLng 



}) ; 

To find out more about Google Maps and how you can 
integrate them with your Android app, go to: 

https:/ / developer, android, com/google/play-services/ maps, 
html 

6. Cursor loaders 

If you do much work with databases or content providers, 
sooner or later you’ll encounter cursor loaders. A cursor loader 
runs an asynchronous query in the background and returns 
the results to the activity or fragment that called it. It manages 
your cursor for you so that you don’t have to. It also notifies 
you if the data changes so that you can deal with it in your 
views. 

You can find out more about cursor loaders here: 

https:/ / developer, android, com/ training/load-data- 
background/setup-loader.html 



you are here ► 



669 



broadcast receivers 



7. Broadcast receivers 



Suppose you want your app to react in some way when a system 
event occurs. You may, for example, have built a music app, and 
you want it to stop playing music if the headphones are removed. 
How can your app tell when these events occur? 

System events include things like the device running low on power, 
a new incoming phone call, or the system getting booted. Android 
broadcasts these system events when they occur, and you can listen 
out for them by creating a broadcast receiver. Broadcast receivers 
allow you to subscribe to particular broadcast messages. This 
means that you can get your app to respond to system events. 




Android 




Receiver 



You can find out more about broadcast receivers here: 

http:/ / developer, android, com/ reference/ android/ content/ 
BroadcastReceiver. html 
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i. App widgets 

An app widget is a small application view that you can add 
to other apps or your home screen. It gives you direct access 
to an app’s core content or functionality from your home 
screen without you having to launch the app. 

Here’s an example of an app widget: 




___ This is a* app widyt- It J^es you 
divedt addess to the app's dove 
•fundtionality- 



To create an app widget, you need an AppWidget Provider Info 
object, an AppWidget Provider class implementation, and a 
View layout. The AppWidgetProviderlnf o object describes 
metadata for the widget, such as its AppWidget Provider class 
and layout. It’s defined in XML. The AppWidget Provider class 
implementation contains the methods that you need to interface with 
the app widget. The View layout is an XML layout that describes 
how the app widget should look. 

To find out how you create your own app widgets, look here: 

http:/ / developer, android, com/guide/ topics/ appwidgets /index, 
html 
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9. NinePatch graphics 

A NinePatch graphic is a stretchable bitmap you can use as a 
view’s background. The image is automatically resized depending 
on the contents of the view and the size of the screen. The clever 
bit is that you define which areas should stretch, and which areas 
shouldn’t. 

As an example, suppose you wanted to use the following image as 
the background of a button: 




You need the image to be able to stretch so that it can 
accommodate different lengths of text, but you don’t want the 
edges of the image to get distorted as it stretches: 




You want this 
area to be able 
to s-fcre-fcdh. 



This avea should only 

►dha^e siz* vevtidally- 

It shouldn't $et wider. 



T 

This area should only dhan^e siz£ 
hovizontally- Y° u don want it to ^et 
-taller, as that would distort the ima^e. 

If you turn the image into a NinePatch graphic, you can get the 
image to stretch exactly how you want. 

Android includes a tool called the Draw 9-patch tool that helps you 
create NinePatch images. You can find out more about the Draw 
9-patch tool and NinePatch graphics in general by following this 
link: 

http:/ / developer, android, com/guide/ topics /graphics/ 2d- 
graphics. html#nine-patch 
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10. Testing 

All modern development relies heavily on testing, and Android comes with 
a lot of built-in support. As the main Android language is Java, you can use 
the standard Java testing frameworks, but Android takes things a whole step 
further by including a testing framework right in the SDK. In fact, Android 
Studio automatically creates a file hierarchy for tests every time you create a 
project. 

Android testing is based on JUnit, with extensions specially built for Android. 
You can use AndroidTestCases for basic component testing. The 
framework includes mocks for objects like Intents and Contexts to 
make the testing of an individual component easier. 

There’s also a special ApplicationTestCase that’s useful for testing 
that the basic configuration of files like AndroidManifest. xml is set up correctly. 

The most impressive thing in the basic test framework is Instrumentation 
Testing. Android apps can be instrumented so that the interactions between a 
component and the operating system can be monitored and changed. This 
means that you can run tests directly on a device that can call the lifecycle 
methods of an activity and fire off intents to the operating system. 

To find out more about the Android testing framework, go here: 

http:/ / d. android, com/ tools/ testing/ testing^android. html 

For more advanced scenario testing, you should look at the Robotium 
testing framework. Robotium builds on the instrumentation testing used 
in the basic Android framework, and takes it to a whole new level. With 
Robotium you can write test code that almost reads like the test scripts that 
manual testers perform. 

For more information on Robotium go to: 

https:/ / code, google, com/p/ robotium/ 
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ActionBar Activity class 370,385 
ActionB arDrawerToggle 
enabling drawer to open and close 420 
modifying items at runtime 418 
syncing 421 
using 417 
action bars 
about 365,367-368 
adding action items to 
defining action items 377-379 
getting activity to inflate menu resource 380 
reacting to item clicks 381 
adding buttons 379 
changing title 412 
code for 384-385,389-390 
creating order activity 382-383 
defining styles in style resource files 373 
enabling up navigation 391-394 
icons on 372, 379 
labels on 372 

minimum API level for supporting 385 
modifying items at runtime 418 
sharing content on 386-388 
themes 
about 368 

AppCompat 370-371 
applying in AndroidManifest.xml 372 
customizing 373 
Holo 368,371,385 
Material 368,371,374,385 
modifying properties of 373 
using on different levels different 385 
updating 425 
uses of 368 

actionProviderClass attribute 387 
action providers 
adding new action 387 
using with action bar 386 



active navigational options, adding to action bar 367 
activities. See also activity life cycle 
about 2,38, 116-117 
chaining multiple 
about 74-75 

calling second activity 82-85 
changing app to send messages 94 
creating AndroidManifest file 80 
creating project 75-77 
creating second activity 78-81 
declaring activities 8 1 
passing data to second activity 86-94 
configuring 14-15 
creating 13 
creating new 78 
file code exercise 21-22 
fragments vs. 282 
interactive app 
about 40 
default 43 
multiple with intents 
about 95-96 

creating chooser 108-112 
displaying activity chooser dialog 100 
intent filters in 101-102, 113 
no matching activities 113 
running app on devices 105-106, 113 
specifying action 97-107 
state of stop 142 
using intent to start 83 
working with layouts 12 
activity categories 

building Starbuzz app using. See also Starbuzz app 
drink detail activity 233 
drinks category activity 232 
top level activity 232 
types of 
about 229 

navigating through 230 
activity chooser dialog, displaying 100 



this is the index 



675 



the ndex 



Activity class 

accessing lifecycle methods 135 
as subclass of Context class 291 
using in Pizza app 371 
activity element 
using label attribute in 372 
using theme attribute in 372 
activity life cycle 
about 116-117,162 
accessing lifecycle methods 135 
fragments lifecycle vs. 327 
from birth to death 131-132 
from create to destroy 134 
guide to methods 151-156 
methods dealing with state of activity in 142 
overriding method in 144 
stopwatch app 
about 118 
activity code of 121 
adding code for buttons 122 
building 118 

complete activity code 157 

creating runTimer() method 123 

dealing with configuration changes 136-140 

foreground lifetime in 151-156 

formatting time on stopwatch app 127 

implementing onStopO 144 

layout code for 119-1 20 

pausing and resuming 151-156 

reset 127 

restoring state of activity 147-149 
rotating device 131-132 
running 128-130 
scheduling code 124-126 
working with activity code 121 
Activity Magnets exercise, updating onClickFindBeer() 
method 61-62 
acti vity_main .xml 
changing layout in 32-33 
controlling app appearance 3 1 
in gradle projects 17 
in Workout app 279 
RelativeLayout element, in 33,38 
TextView element in 33 
ActivityNotFoundException 82, 99 
adapters 



about 250-251 
array. See Array Adapter 
binding listAdaper to List View 29 1 
RecyclerView 
about 605 

adding interface to 634 

code for Captionedlmages Adapter 611 

creating 606 

creating constructor 609 

decoupling with interface 633 

keeping reusable 633 

using 613 

ViewHolder for 607-610 
Adapter View class 
ListView using 25 1 , 29 1 
spinners using 25 1 

adb (Android Debug Bridge) 654-658 
add() method 301 
addToBackStack() method 301 
ALTER TABLE command 466 

Android application package (APK) file, in Android app 
28 

Android apps 

activities in. See also activities 
about 2, 38, 116-117 
configuring 14-15 
creating 13 

file code exercise 21-22 
working with layouts 12 
animation 667 
APK file in 27 
content providers 665 
creating 
about 4 

building app. See basic app, building 
changing app 31-37 
development environment 5 
installing Android Studio 6 
installing Java 6 
running app 23-30 
distributing 664 
embedding maps 668-669 
Java in, purpose of 2 
layouts in 
about 2, 38 
creating 15 
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file code exercise 19-20 
working with activities 12 
resource files in 2 
rotating device 131-132 
running app on devices 105-106 
running inside separate process 129 
storing every instance variable 141 
structure of 366-367 
testing 673 
using Java in 4 

Android Debug Bridge (adb) 654-658 
Android devices 
about 2 
app layouts for 

determining which layout device is using 320 
different folder options 309 
layouts for phone 315-316,319 
layouts for tablets 314 
phone vs. tablet 306-307 
putting screen- specific resources in folders 308 
running code 320-321 
apps and rotating 131-132, 304, 355-357 
emulator vs . physical 113 
running app on devices 105-106 
using app across all 270-27 1 
Android emulator 23-30,659-661 
AndroidManifest .xml 
about 80 

applying theme in 372 
declaring services in 548 
declaring Services in 582 
DEFAULT category in 99, 114 
for stopwatch app 128 
fragments and 287 
in gradle projects 17 
intent filters in 101-102, 113 
registering list activities in 249 
Android platform 3 

Android Runtime (ART) 3, 30, 38, 650-652 
Android SDK (Software Development Kit) 5 
Android Studio 
as version of IntelliJ IDEA 5 
building apps using 7 
console in 28 

creating AndroidManifest file with 80 
gradle build system and 



about 7 

key files and folders in 17 
installing 6 

layout file code exercise 19-20 
New Project Screen 9-10 
project created with wizard 
about 15 

code editor 18,32 
design editor 18,32 
folder structure in 16 
useful files in 17 
Welcome Screen 6, 8 
XML created by 37 
Your Virtual Devices screen 24 
Android versions 1 1 
Android Virtual Device (AVD) 
about 23 
creating 24-26 

launching Android Studio emulator with 28 
running app in 27-28 
animation 667 
ANT build tool 7 
API levels 

adding action bar at different 368 
minimum level for supporting action bars 385 
specifying 10 

support libraries for 369-370 
using style resource depending on 374 
APIs, in application framework 3 
APK (Android application package) file 
about 27 

Java source code in 30 
appcompat library, v7 369-37 1,378 
AppCompat themes 370-371 
application element 
using label attribute in 372 
using theme attribute in 372 
application framework 
about 3 
APIs in 3 

app namespace, in showAs Action attribute 378 
app/src/main folder 38 
AppTheme style 375 
app widgets 67 1 
ArrayAdapter 
about 251 
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connecting ListView to arrays using 251-252, 407 
Cursor Adapter vs. 496 
populating list view with 292 
arrays 

replacing in ListView data in 494 
static array data 250 
string 53-54, 65, 72, 239, 402-404, 407 
using Array Adapter to connect list views to 407 
ART (Android Runtime) 3, 30, 38, 650 
ASC keyword 480 
AsyncTask 
about 471,535 
executing 536 

parameters defining 530, 535 
performing asynchronous tasks 530-534 
summary of 539 
AUTOINCREMENT 447 
AVD (Android Virtual Device) 
about 23 
creating 24-26 
reusing 30 
running app in 27-28 
test drive app 29-30 
AVG() functions 481 
AWT 4 

B 

Back button 299, 340-341 , 391 , 424 
background attribute 406 
back stacks 299, 341 , 426 
basic app, building 
about 7 

adding activities and layouts 12-15 
configuring project 9 
creating project 8 
specifying API level 10 
Bates., Bert Head First Java 4 
Beer Advisor app 
about 40-41 

changing to linear layout 187-188 
connect activity 55-58 
creating project 40-42 
default activity and layout 43 
updating layout 44-54 
adding components with design editor 44-45 
adding values to spinner 53-54 



buttons and text in View class 45-47 
changes to XML 48-49 
using string resources 50-5 1 
write logic 59-7 1 
accessing text view methods 60 
building custom Java class 66-68 
first version of activity 63-65 
referencing text views 59-60 
retrieving values in spinner 60 
second version of activity 69-7 1 
setting text in TextView 60 
beginTransaction() method 341 
Be the... exercises 
activity 159-160 
folder structure 3 1 0-3 1 3 
fragment 360-363 
intent 103-104 
layout 198-201 
SQLite Helper 463-464 
Binders 570,572-573 
bindService() method 588 
BLOB data type 446 
bottom value 182,184 
bound services 
about 542 
odometer app 
about 569-570 

binding to service 572-573,586-588 
creating project 569-570 
displaying distance traveled 589-594 
getting distance device travels 574-578 
getting miles for distance 579-582 
broadcast receivers 670 
build folder, in gradle projects 17 
build tools 7 

Bundle parameter 137-141, 304 
Button element 
about 45-47 
as GUI component 207 
attributes of 49 
calling a method 56-57 
in multiple activities app 76 
in Relative Layout element 47-48 
making public and void return type 58 
buttons 
about 45 
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adding images to 217 
Back 299,340-341,391,424 
Create Order 367,379 
Create virtual device 23 
moving to right layout 183 
radio 212-213 

Reset 120, 127, 336, 346-350, 351 
Start 119,335-336,346-350,351 
Stop 120,335-336,346-350,351 
toggle 208 
Up 391-394,420 

bypass configuration changes symbol (I) 136 

c 

CalledFromWrongThreadException 1 23 
CaptionedlmagesAdapter 632-637 
CardView 
about 599-600 
adding data to 610 
contents of 609-610 
creating 603-604 
support libraries for 602 
cardview library, v7 369 
category activities 
about 229 

building Starbuzz app using drink 232 
drinks category activity 
about 247 

adding array adapter 252 

creating DrinkCategory Activity 235, 249 

full code for 258 

responding to clicks with listener 256-257 
starting DrinkCategory Activity 241, 257 
working with data 250 
in app structure 234 
navigating through 230 
structure of apps and 366-367 
center_horizontal value 182,184 
center value 182,184 
center_vertical value 182, 184 
changeCursor() method 523 
changing apps 3 1-37 

CheckBox element, as GUI component 210-211 
checkboxes 508-510,531 
choiceMode attribute 406 



closeDrawer() method 413 
close() method 489 
code editor, Android Studio 18,32 
Code Magnets exercises 

completing StopwatchFragment onClick() method 
349-350 
constructing 

onFavoriteClicked() method 510-511 
query() method 483-484 

displaying correct fragment in frame layout 409-410 
columnCount attribute 189,225 
command line tool, adb 654-658 
commitO method 301 

configuration changes , dealing with 136-140 
configuration files, in folder structure in Android Studio 
project 16 

constructor vs. onCreate() method 129 
contentDescription attribute, using with Image View 238, 
268 

content providers 665 

Content Values object, holding name/value pairs of data 
448-449 

Context abstract class 135 
Context class, Activity class as subclass of 291 
ContextTheme Wrapper class 135 
ContextWrapper class 135 
core applications 3 
COUNT() functions 481 
Create a virtual device button 23 
createChooser() method 108-109, 113 
CreateMessageActivity 88-91,98 
Create Order button 367, 379 
CREATE TABLE command 447 
current state of activity, saving 137-138 
CursorAdapter 494-499 
cursor adapters 471 
Cursor class 440 
cursor loaders 669 
cursors 
about 471 

adding column to 509 
close database and 489 
code for getting 486 
creating 497 

get database data with 475 
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getting values 489 
navigating 487-488 
populating list view with 517 
refreshing automatically 522-525 
Custom Java class, in interactive apps 40 

D 

data types, SQLite 446 
DEFAULT category 99, 114 
DelayedMessageService 
adding button for 549 
code for 

displaying message in log 547 
displaying message in notification 562-566 
displaying message in Toast 553-555 
creating 544 

displaying messages with 546 
name attribute and 548 
delete() method 450,510 
density-independent pixels (dp) 166 
DESC keyword 480 

design editor, Android Studio 18, 32, 44, 52 
detail activities 
about 229 

building Starbuzz app using drink 233 
drink detail activity 
code for 263-266 
creating DrinkActivity 235 
displaying data for single record 259 
launching DrinkActivity 265 
retrieving data from intent 260 
updating views with data 261-262 
in app structure 234 
navigating through 230 
structure of apps and 366-367 
Detail Activity .j ava 316,319 
detail/edit activities 
about 229 

structure of apps and 366-367 
development environment 5 
device configuration 
changes to 162 

rotating screen changing 132, 304, 355-357 
DEX code, Android Runtime running 30 
distanceTo() method 576 
distributing apps 664 



divider attribute 406 
dividerHeight attribute 406 
doInBackground() method 530, 532-536, 539 
dp (density independent pixels) 166 
drawable folders 308 
DrawerLayout 
about 399 
creating 406-407 
FrameLayout in 405,413 
DrawerLayout APIs 369 
DrawerLayout class, adding 405-406 
drawerList 413 

DrawerListener , ActionB arDrawerToggle as 417 
DrinkActivity 474-492 
about 473 

adding favorites to 507-525 
adding column to cursor 509 
code for 513-514 
displaying favorites in 515-521 
putting important information in top level activity 
507 

refreshing cursors automatically 522-525 
updating database by responding to clicks 510 
code for 474, 490-492, 537-538 
cursors 

close database and 489 
code for getting 486 
get database data with cursor 475 
getting values 489 
navigating 487-488 
databases making app run slow 
about 525-529, 539 

AsyncTask performing asynchronous tasks 530-539 
getting reference to database 484-485 
queries 
about 476 

applying conditions to 478-479 
creating 477 
sorting data in 480 
specifying conditions as Strings 479 
specifying table and columns 478 
using SQL functions in 481 
DrinkCategoryActivity 493-506 
about 473 

code for 493,504-506 
CursorAdapters 
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about 494 

closing database and 499 

mapping data using SimpleCursorAdapter to views 
497 

reading data 495-496 
replacing array data in ListView 494 
Drink Magnets exercise, populating views with data 
261-262 

drop-down list of values. See spinner element 
DROP TABLE command 466 

E 

Eclipse 7 
EditText class 91 
EditText element 
about 76 

as GUI component 206 
emulator, Android 659-661 
end value 184 

entries attribute, using for static array data held in strings. 

xml 250 
event listener 

implementing 241,244,256-257 
set listener to ListView 242 
execSQL() method 466 
execute() method 536 
exercises 

activity file code 21-22 

app layouts for phones and. tablets 310-313 

applying activity code to situations 159-160 

calling custom Java class 67-68 

center Send Button in grid layout 195, 224 

changing 

app to linear layout 187-188 
TopFragment 640, 642 

choosing type of thread for block of code to run on 
527-528 

completing StopwatchFragment onClick() method 
349-350 
constructing 

onFavoriteClicked() method 510-511 
query() method 483-484 
converting code to fragment 328-331 
creating 

activity that binds Java array to spinner 255, 267 



bound service 583-584 
layout with check boxes 221-223 
RecyclerView 622-625 
started service 567-568 

determining results of onCreate() method 453-454 
displaying correct fragment in frame layout 409-410 
fragment layout code vs. Java code 360-363 
identifying compatible actions with intents 103-104 
layout file code 19-20 
matching 

layout to screen layout produced 198-201 
SQLite Helper code to users 463-464 
organizing ideas into types of activity categories 229 
populating 

list view from DrinkCategory Activity 500-503 
views with data 261-262 
putting code in 

CreateMessageActivity 89-90 
Detail Activity .java 317-318 
restoring state of activity in activity life cycle 145-146 
testing user clicks to display text of item 245-246 
updating 

onClickFindBeer() method 60 
TextView element 86-87 
writing code for TopFragment 641 , 643 
explicit intents 101,113,559 
exported attribute 548 

F 

favorites, adding to DrinkActivity 507-525 
about 508 

databases making app run slow 
about 525-529, 539 

AsyncTask performing asynchronous tasks 530-539 
top level activity 
adding column to cursor 509 
code for 513-514 
displaying favorites in 515-521 
putting important information in 507 
refreshing cursors automatically 522-525 
updating database by responding to clicks 510 
fill_horizontal value 182,184,193 
fill_parent setting 166 
fill value 182,184 
fill_vertical value 182,184 



you are here ► 681 



the ndex 



findFragmentById() method 281 , 287 
findFragmentByTagO method 427-428 
findViewById() method 60-61 , 63-64, 203, 287, 327 
flags parameters 498 
folders, screen specific 
layout-large 308,314 
options for 309 

putting screen-specific resources in 308 
folder structure, in Android Studio project 16 
foreground lifetime 151-156 
Fragment class 278,284,323 
fragment element 
about 279 

adding fragment to activity using 300 
fragment lifecycle methods 283-284, 323 
fragments 
about 272 
activity vs. 282 
adding 

and removing 301 
tags to 427-428 
to frame layout 30 1 
device layouts 

determining which layout device is using 320 
different folder options 309 
layouts for phone 3 1 5-3 16,319 
layouts for tablets 314 
phone vs. tablet 306-307 
putting screen- specific resources in folders 308 
running code 320-321 
layout code 277-278,279 
linking 295-305 
about 295 
code for 305 

interface for decoupling fragment 296-298 
replacing instances of WorkoutListFragment 
300-301 

rotating device 304 
updating Main Activity .java 302 
working with back button 299 
nested 
about 325 

adding StopwatchFragment to WorkoutDetailFrag- 
ment 337-343 

attaching onClickListener to buttons 351 



code for 332-334, 352-354, 358-359 
creating 326 

error output for buttons in 345-346 
implementing onClickListener 349 
implementing StopwatchFragment onClick() method 
349-350 

needing nested transactions 341-342 
onClick attribute and 347-348 
rotating device containing 355-357 
not type of Context 291 
Pizza app 
about 400 

changing TopFragment 639,644-646 
creating PastaFragment 403 
creating PizzaFrament 401 
creating StoresFragment 404 
creating TopFragment 401 
RecyclerView 612-614, 617-618, 636-637 
StopwatchFragment in 
adding to WorkoutDetailFragment 337-343 
code for 332-334, 352-354 
error output for buttons in 345-346 
layout for 335-336 
onClick attribute and 347-348 
onClick() method 349-350 
onCreateView() method 351 
title getting out of sync with 424 
working with back button 299 
Workout app 
adding to project 276 
passing workout id 280 
WorkoutDetailFragment 
about 274 

adding stopwatch fragment to 326 
adding StopwatchFragment to 337-343 
creating 276-281 
running 286-287 
setting views values 285 
WorkoutListFragment 
about 274 
code for 293 
creating 288-291 
replacing instances of 300-301 
running 294 
updating code 292 
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WorkoutListListener 
creating interface called 296 
implementing interface 298 
FragmentTransaction 301 
FrameLayout class 604 
FrameLayout element 
about 300 

adding fragment to 301 
in DrawerLayout 405 ,413 
functions, SQL 481 

G 



getld() method 203,349 
getlntent() method 88,92,260 
getIntExtra() method 88 
getlnt() method 489 
getItemCount() method 606 
getListView() method 248, 289 
getMiles() method 569, 579, 585, 589, 593 
getname() method 275 
getOdometer() method 573 
getPendingIntent() method 560 
getReadableDatabase() method 484-486 
getSelectedItem() method 60,63,65 
getStringExtra() method 92 
getString() method 111, 489 
getSystemService() method 561, 578 
getView() method 285 
getWidth() method 203 
getWritableDatabase() method 484-485 
Google Maps, embedding 668-669 
GPS system 576,578 

gradle build system, Android Studio and 7, 17 
graphics, NinePatch 672 
gravity attribute 181-182,193 
grid layout 
about 165 
adding views to 190 



creating new 191-195 
displaying views in 189 
full code for 196 
sketching 192 
summary for creating 197 
gridlayout library, v7 369 
GridLayoutManager 615 
Groovy 7 

GROUP BY clauses 482 
GUI components 
adding to layout 47-49 
as type of view 202 
Button element as 207 
CheckB ox element as 2 1 0-2 1 1 
EditText element as 206 
image buttons os 217-218 
ImageView element os 215-216 
layouts and 201 

RadioB utton element as 2 1 2-2 1 3 
Scroll View element as 219 
Spinner element as 214 
Switch element as 209 
Text View element as 205 
Toasts element as 220 
ToggleButton element as 208 

H 

Handlers 
about 124 
creating 125,553 
posting code using 127 
scheduling code using 124-126 
HAVING clauses 482 
Head First Java (Sierra and Bates) 4 
Head First SQL (O’Reilly media) 482 
hint text ,177 

Holo themes 368,371,374,385 

I 

icon attribute 372,377,385 
icons 

adding to action bar 379 

enabling icon in action bar 420 

using Android action bar icon pack 379 



getActionBar() method 393 
getBrands() method 55,66-68,70 
getChildFragmentManager() method 339, 341, 341-342 
getDescription() method 275 
getFragmentManager() method 281 , 337-343, 428 
getHeight() method 203 
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id attribute 45, 170, 377 
IDEs 

building apps using 7 
learning to use 65 
id of clicked item, passing 257 
ImageButton element 218 
images 

adding to buttons 217 
CardView 604,609 
mipmap 372 

3D in Material Design 599 

using R.drawable .image .name to add 236-237, 268 
ImageView 

as GUI component 215-216 
in Cardview 609-610 
in PizzaDetailActivity 627 
using contentDescription attribute with 238, 268 
implicit intents 97, 99, 101-102, 113 
insert() method 448, 510 
INTEGER data type 446 
IntelliJ IDEA 5 
Intent .Action_send 97 
Intent class 83 
intents 
about 82 
adding text to 9 1 
changing to use action 98 
explicit 101,113,559 
filter 101-102,113 
implicit 97,99,101-102,113 
multiple activities and 
creating chooser 108-112 
displaying activity chooser dialog 100 
intent filters in 101-102, 113 
no matching activities 113 
running app on devices 105-106, 113 
specifying action 97-107 
on stopwatch app 128 
passing to Android 87 
pending 560 

putting extra information in 88 
retrieving data from 260 
sharing content with 386 
specifying content with 388 
starting activities using 83, 95 



IntentService class , 544-545 
interactive apps, building 
about 39-41 
connect activity 55-58 
creating project 40-42 
default activity and layout 43 
updating layout 44-54 
adding components with design editor 44-45 
adding values to spinner 53-54 
buttons and text in View class 45-47 
changes to XML 48-49 
using string resources 50-5 1 
write logic 59-7 1 
accessing text view methods 60 
building custom Java class 66-68 
first version of activity 63-65 
referencing text views 59-60 
retrieving values in spinner 60 
second version of activity 69-7 1 
setting text in TextView 60 
int values, retrieving 88 
invalidateOptionsMenu() method 418 
isClickable() method 203 
isFocused() method 203 
itemClicked() method 298 
item element 
attributes in 377-378 
modifying properties of theme using 373 
sharing action using 387 



Java 

activities 2 

files in folder structure in Android Studio project 16 
installing 6 
purpose of 2 
resource files 2 
source code in APK file 30 
using to develop Android apps 4 
Java classes, building custom 66-68 
Java Development Kit (JDK), installing 6 
java folder, in gradle projects 17 
Java Runtime Edition (JRE), installing 6 
Java SE 4 

Java Virtual Machine (JVM) 
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Android Runtime vs. 650 
emulator vs . physical device 113 
overhead of 30 

L 

label attribute 372, 385 
lay out_above attribute 171 
lay out_alignB ottom attribute 171 
lay out_alignLeft attribute 171 
lay out_alignParentB ottom attribute 169 
layout_alignParentLeft attribute 169 
layout_alignParentRight attribute 169 
layout_alignParentTop attribute 169 
lay out_alignRight attribute 171, 183-184 
lay out_alignTop attribute 171 
lay out_below attribute 171 
layout_centerHorizontal attribute 169 
layout_centerInParent attribute 169 
lay out_center Vertical attribute 169 
layout_column attribute 1 93 , 1 94 
lay out_columnSpan attribute 194 
layout hies 
changing 

activity_main.xml hie 32-33 
to use string resources 5 1 
referencing strings in 34 
layout folder 
in gradle projects 17 
in interactive apps 43 
lay out_gravity attribute 183, 193,406 
layout_height attribute 45, 166, 174-175, 405-406 
layout-large folders 308 

Layout Magnets exercise, center Send Button in grid 
layout 195,224 
layout manager 615-616 
lay out_marginB ottom attribute 172 
layout_marginLeft attribute 172 
layout_marginRight attribute 172 
layout_marginTop attribute 172 
layout_row attribute 193 
layouts 
about 2, 38 

as hierarchy of views 204 
creating 15 

determining extra space views take up 1 80 



device app 

determining which layout device is using 320 
different folder options 309 
layouts for phone 3 1 5-3 16,319 
layouts for tablets 314 
phone vs. tablet 306-307 
putting screen- specihc resources in folders 308 
running code 320-321 
hie code exercise 19-20 
for StopwatchFragment 335-336 
frame 300 
grid 

about 165 

adding views to 190 
creating new 191-195 
displaying views in 189 
full code for 196 
sketching 192 
summary for creating 197 
GUI components and 47-49, 201 
hint text ,177 

in multiple activities app 79, 86-87 
interactive app 
about 40 
default 43 

limitations of design editor in 52 
linear 
about 165 

adding weight to views 178-180 
changing basic 176-181 

displaying views in order they appear in layout XML 
174 

displaying views in single row or column 174 
full code for 185-186 
making stretch by adding weight in 178 
summary for creating 186 
using gravity attribute in view 181 , 184 
using layout_gravity attribute in views 183-184 
relative 
about 165 
adding padding 167 

displaying views in relative positions 166 
positioning views relative to other views 170-171 
positioning views relative to parent layout 168-169 
summary for creating 173 
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using margins to add distance between views 172 
setting width and height 166 
ViewGroup and 
about 203-204 
layout XML converted to 204 
relative layout as 204 
working with activities 12 
layout_toLeftOf attribute 171 
layout_toRightOf attribute 171 
layout_weight attribute 178-180 
layout_width attribute 45, 166, 174-175,405-406 
layout XML 204 
leanback library, vl7 369 
left value 182,184 
libraries 
about 3 

CardView v7 602 

in folder structure in Android Studio project 16 
RecyclerView v7 602 
using support 369-370 
linear layout 
about 165 

adding weight to views 178-180 
changing basic 176-181 
displaying views in 
order they appear in layout XML 174 
single row or column 174 
full code for 185-186 
making stretch by adding weight in 178 
using gravity attribute in view 181 , 184 
using layout_gravity attribute in views 183-184 
LinearLayoutManager 615 
Linux kernel 3 
ListActivity class 248 
listAdaper 291 
listener, event 

implementing 241,244,256-257 
set to ListView 242 
ListFragment class ,288-291 
ListView 

advantages of using 248 
binding listAdaper to 29 1 
creating list activity 249 
display list of options using 239 
in DrawerLayout 405^406 
navigating to data using 23 1 



reading data 495 
RecyclerView vs . 631 
replacing array data in 494 

responding to clicks with listener 241 , 244, 256-257 
set listener to 242 

using AdapterView class with 25 1 , 29 1 , 407 
LocationListener 576-578 
logcat, viewing 546 
Log.d () method 546 
Log.e() method 546 
logging messages 546 
Log.i() method 546 
Log.v() method 546 
Log.w() method 546 
Log.wtf() method 546 

M 

Main Activity .j ava 
controlling what app does 3 1 
default support library 370 
implementing WorkoutListFragment interface 298 
in gradle projects 17 
in Workout app 279 
in WorkoutListFragment 293 , 302 
phone layout 315 
main event thread 526 
maps, embedding 668-669 

margins, adding distance between views using 172 
match_parent setting 166 
match_parent value 175 
Material Design 
about 597-599 
card views 599-600 
Pizza app using 
adding data 601 
adding Pizza class 601 
adding support libraries 602 
changing TopFragment 639, 644-646 
creating CardView 603-604 
PizzaDetailActivity 627-630, 638, 646 
RecyclerViews. See RecyclerViews 
3D in 599 

Material themes 368,371,374,385 
Maven 7 

MAX() functions 48 1 

menu elements, action items described in 377 
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menu resource file 
defining action items in 377 
inflating 380 
meta-data element 392 
methods 
add() 301 

addToBackStack() 301 
beginTransaction() 341 
bindService() 588 
changeCursor() 523 
close() 489 
closeDrawer() 413 
commit() 301 

createChooser() 108-109, 113 
deleteO 450 
delete() method 510 
distanceTo() 576 

doInBackground() 530,532-536,539 
execSQL() 466 
execute() 536 

findFragmentById() 28 1 , 287 
findFragmentByTagO 427-428 
findViewById() 60-61 , 63-64, 203, 287, 327 
getActionBar() 393 
getBrands() 55,66-68,70 
getChildFragmentManager() 339 
getDescription() 275 

getFragmentManager() 28 1 , 337-343 , 428 

getHeight() 203 

getld() 203,349 

getlnt() 489 

getlntent() 88,260 

getIntExtra() 88 

getItemCount() 606 

getListView() 248,289 

getMiles() 569,579,585,589,593 

getname() 275 

getOdometer() 573 

getPendingIntent() 560 

getReadableDatabase() 484-486 

getSelectedItem() 60,63,65 

getStringO 111,489 

getStringExtra() 92 

getSystemService() 561,578 

getView() 285 

getWidth() 203 

getWritableDatabaseQ 484-485 



insert() 448,510 
invalidateOptionsMenu() 418 
isClickable() 203 
isFocused() 203 
itemClickedO 298 
Log.d () 546 
Log.e() 546 
Log.i() 546 
Log.v() 546 
Log.w() 546 
Log.wtf() 546 
moveToFirst() 488 
moveToLast() 488 
moveToNextO 488 
moveToPrevious() 488 
onActivityCreated() 283,327 
onAttach() 283,296,327 
onBackStackChanged() 426 
onBind() 571,573,575,592 
onB ind Vie wHolder () 606, 609-610, 632 
onClick() 349-350, 549-550, 634-635 
onClickFindB eer() 58-59, 61-62, 64-65, 70 
onClickResetO 120-122, 349-350 
onClickStart() 119, 121-122,349-350 
onClickStopO 120-122, 349-350 
onConfigurationChanged() 421 
onCreate() 
about 57, 161 

adding new table column 462 
as Service class method 575, 577, 589 
calling 156 

calling in creating database 447 , 469 
constructor vs. 129 
enabling icon in action bar 420 
enabling up button 393 
fragments layout and 283 
in activity life cycle 133, 143, 151-153, 327 
in adding favorites column 509 
in creating fragments 28 1 
in multiple activities app 77, 92 
in RecyclerView 6 1 9-62 1 
in SQLite helper 444 
in stopwatch app 117, 129 
on rotated device 131,356 
SQLite helper 456-459 
updating action bar 425 
onCreateOptionsMenu() 380, 382, 376 
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onCreateView() 283, 290, 327, 351 , 357 
onCreateViewHolder() 606 
onDestroyO 133-134, 143, 152-153, 161,283,327, 
575 

onDestroyView() 283,327 
onDetach() 283,327 
onDowngrade() 455-456, 461 , 469 
onDowngrade() method 458-459 
onDrawerClosed() 418 
onDrawerOpened() 418 
onFavoriteClicked() 510,529,536 
onHandleIntent() 544-545,552-553 
onltemClickO 241 , 256-257, 408 
onItemClickListener() 241 , 256-257, 264, 408, 517, 
631 

onListItemClick() 248 , 256-257 , 265 , 289 
onLocationChanged() 576 
onOptionsItemSelected() 376, 381-382, 420 
onPause() 150-156,161,283,327 
onpostCreate() 421 
onPostExecute() 530,534-535,539 
onPreExecute() 530-531,539 
onPrepareOptionsMenu() 418 
onProgressUpdate() 530, 533, 535, 539 
onRestart() 142-143, 149, 161, 327, 523 
onResume() 150-155,161,283,327 
onSaveInstanceState() 137-138, 304, 355, 425 
onSendMessage() 77, 84, 93, 99, 111 
onServiceConnected() 587 
onServiceDisconnected() 587 
onStart() 142-144, 148-149, 156, 161,283,285-286, 
327,588 

onStartCommand() 553,575 

onStop() 142-144, 147-148, 161, 283, 327, 588 

onUpgradeO 444, 455-456, 458-460, 469 

post() 124-125,552 

postDelayed() 124-125 

publishProgress() 533,539 

put() 448 

putExtra() 88 

query() 477-480,484 

remove() 301 

replace() 427 

requestFocus() 203 

requestLocationUpdates() 578 

runTimer() 



creating 123 
in rotated device 131 
in stopwatch app 125, 129, 139, 148, 155 
updating stopwatch 121 
selectltem() 411,414 
set ActionB arTitle() 412,426 
setAdapter() 253 
setContentIntent() 560 
setContentView() 129, 249, 278-279, 356 
setDisplayHomeAsUpEnabled() 393 
setItemChecked() 426 
setOnClickListener() 351 
setShareIntent() 388 
setText() 60 
setTransition() 301 
setVisibility() 203 
setWorkout() 280 
SQLiteDatabase query() 477 
startActivity() 83,99,113,117 
startService() 550 
superclass 144 
syncS tate() 421 
tostring() 275 
toString() 253 
unbindService() 588,593 
update() 449,510,532 
updateMyDatabase() 462 
ViewById() 59 
watchMileage() 589,593 
MIN() functions 481 

minimum SDK (Software Development Kit) 
in API level 17 apps 370 
in basic apps 10 
in interactive apps 42 
mipmap image 372 
moveToFirst() method 488 
moveToLast() method 488 
moveToNext() method 488 
moveToPrevious() method 488 
mplicit intents 99 
multiple activities app 
about 73-75 

creating AndroidManifest file 80 
creating proj ect 75-77 
intents and 
about 95-96 
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creating chooser 108-112 
displaying activity chooser dialog 100 
intent filters 101-102,113 
no matching activities 113 
running app on devices 105-106, 113 
specifying action 97-107 
second activity 
AndroidManifest file 78-81 
calling second 82-85 
creating 78-81 
declaring activities in 8 1 
passing data to 86-94 

N 

name attribute 373,548 
navigation drawers 
about 397-398,507 
ActionBarDrawerToggle 416-423 
adding 

DrawerLayout 405 
fragments 399-404 
tags to fragments 427 
closing 413 
code for 429-436 
creating 406-407 

dealing with configuration changes 425 
finding fragments using tags 428 
reacting to changes in back stack 426 
responding to clicks in list view 408-413 
title and fragment getting out of sync 424 
nested fragments 
about 325 

adding StopwatchFragment to WorkoutDetailFragment 
337-343 

attaching onClickListener to buttons 351 
code for 332-334,352-354,358-359 
creating 326 

error output for buttons in 345-346 
implementing onClickListener 349 
implementing StopwatchFragment onClick() method 
349-350 

needing nested transactions 341-342 
onClick attribute and 347-348 
rotating device containing 355-357 
nested transactions 341-342 



New Project Screen (Android Studio) 9-10 
NinePatch graphics 672 
non-static data, array for 250 
notification service 556-566 
about 543,556-557 
code for 562-566 
creating 558 

sending notification using 561 
starting activity using 559-560 
nullColumnHack String value 448 
NUMERIC data type 446 

o 

odometer app 
about 569-570 

binding to bound service 572-573 
binding to service 586-588 
creating project 569-570 
displaying distance traveled 589-594 
getting distance device travels 574-578 
getting miles for distance 579-582 
OdometerService 570, 580-581, 592-593 
onActivityCreated() method 283, 327 
onAttach() method 283, 296, 327 
OnBackStackChangedListener 426 
onBackStackChanged() method 426 
OnBackStackListener 428 
onBind() method 571,573,575,592 
onBindViewHolder() method 606, 609-610, 632 
onclick attribute 56 

onClick attribute 347-348, 359, 508, 510 
onClickFindBeerO method 58-59, 61-62, 64-65, 70 
onClickListener 349,351,359 
onClick() method 349-350, 549-550, 634-635 
onClickReset() method 120-122, 349-350 
onClickStart() method 119, 121-122, 349-350 
onClickStopO method 120-122, 349-350 
onConfigurationChanged() method 421 
oncreate() method 57 
onCreate() method 
about 161 

adding new table column 462 
as Service class method 575, 577, 589 
calling 156 

calling in creating database 447 , 469 
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constructor vs. 129 
enabling icon in action bar 420 
enabling up button 393 
fragments layout and 283 

in activity life cycle 133, 137-141, 143, 151-153, 327 
in adding favorites column 509 
in creating fragments 281 
in multiple activities app 77, 92 
in RecyclerView 619-621 
in SQLite helper 444 
in stopwatch app 117, 129 
on rotated device 13 1 , 356 
SQLite helper 456-459 
updating action bar 425 
onCreateOptionsMenu() method 380, 382, 376 
onCreateViewHolder() method 606 
onCreateView() method 283, 290, 327, 351, 357 
onDestroy() method 133-134, 143, 152-153, 161, 283, 
327,575 

onDestroyView() method 283,327 
onDetach() method 283,327 
onDowngrade() method 455-456, 458-459, 461 , 469 
onDrawerClosed() methods 418 
onDrawerOpened() method 418 
onFavoriteClicked() method 510, 529, 536 
onHandleIntent() method 544-545, 552-553 
onItemClickListener() method 241 , 256-257, 264, 408, 
517 

OnltemClickListenerO method 631 
onItemClick() method 241 , 256-257, 408 
onListItemClick() method 248, 256-257, 265, 289 
onLocationChanged() method 576 
onOptionsItemSelected() method 376, 381-382, 420 
onPause() method 150-156, 161, 283, 327 
onpostCreate() method 421 
onPostExecute() method 530, 534-535, 539 
onPreExecute() method 530-531, 534, 539 
onPrepareOptionsMenu() method 418 
onProgressUpdate() method 530, 533, 535, 539 
onRestart() method 142-143, 149, 161, 327, 523 
onResume() method 150-155, 161, 283, 327 
onSaveInstanceState() method 137-138, 304, 355, 425 
onSendMessageQ method 77, 84, 93, 99, 111 



onServiceConnected() method 587 
onServiceDisconnected() method 587 
onStartCommand() method 553,575 
onStart() method 142-144, 148-149, 156, 161, 283, 
285-286,327,588 

onStop() method 142-144, 147-148, 161, 283, 327, 
588 

onUpgrade() method 444, 458-460, 462, 469 
onUpgrade() methods 455-456 
orderlnCategory attribute 377-378 
ordering data, using queries for 480 
organizing ideas. See also Starbuzz app 
about 228 

types of activity categories 
about 229 

navigating through 230 
using ListViews to navigate to data 23 1 
orientation attribute 174 

P 

packages 
naming 9 
wizard forming 9 
padding, adding to layout 167 
Params parameter, AsyncTask defined by 530, 535 
parent Activity Name attribute 392 
parent attribute, style inheriting properties from 373 
parent layout 
about 165 

positioning views relative to 168-169 
pending intents 560 
phones, device app layouts for 
about 306-307 

determining which layout device is using 320 
layouts for 3 1 5-3 16,319 
putting screen- specific resources in folders 
about 308 

different folder options 309 
running code 320-321 
pixels, density independent 166 
Pizza app 

adding action items to action bar 
defining action items 377-379,380 
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reacting to item clicks 381 
adding DrawerLayout 405-406 
bringing content forward 639 
changing MainActivity to use Activity class 37 1 
code for 389-390,406 
creating 

DrawerLayout 406-407 
order activity 382-383,384-385 
PastaFragment 403 
PizzaFrament 401 
StoresFragment 404 
TopFragment 401 

defining styles in style resource files 373 
enabling up navigation 391-394 
Material Design in 
about 597-599 
adding data 601 
adding Pizza class 601 
adding support libraries 602 
card views 599-600 
changing TopFragment 639, 644-646 
creating CardView 603-604 
PizzaDetailActivity 627-630, 638, 646 
RecyclerViews. See RecyclerViews 
3D in 599 
navigating 366-367 
navigation drawers 
about 398-399 

ActionBarDrawerToggle 416-423 
adding DrawerLayout 405 
adding fragments 399-404 
adding tags to fragments 427 
closing 413 
code for 429,429-436 
creating 406-407 

dealing with configuration changes 425 
finding fragments using tags 428 
reacting to changes in back stack 426 
responding to clicks in list view 408-415 
title and fragment getting out of sync 424 
running 375 

setting background color 406 
sharing content on action bars 386-388 
structure of 400 
support libraries in 370 



themes used in 371 

PizzaDetailActivity 627-630, 638, 646 
PizzaMaterialFragment 636-637 
Pool Puzzle exercises 

creating activity that binds Java array to spinner 255, 
267 

populating list view from DrinkCategory Activity 
500-503 
putting code in 

CreateMessageActivity 89-90 
Detail Activity .java 3 1 7-3 1 8 
pop-up messages 220 
postDelayed() method 124-125 
post() method 124-125,552 
primary key columns 446 

Progress parameter, AsyncTask defined by 530, 535 
public, making button 58 
publishProgress() method 533,539 
putExtra() method 88 
put() method 448 

Q 

QEMU (Quick Emulator) 660-661 
queries, database 
about 476 

applying conditions to 478-479 
creating 477 
sorting data in 480 
specifying conditions as Strings 479 
specifying table and columns 478 
using cursor loaders in 669 
using SQL functions in 481 
query() method 477-480,484,486 

R 

RadioButton, as GUI component 212-213 
RadioGroup element 2 1 2-2 1 3 
R.drawable .image .name 236-237, 268 
REAL data type 446 
ReceiveMes sage Activity 
about 78-79 
putting information in 88 
using information in intent using 92-93 
recyclerview library, v7 369 
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RecyclerView Magnets exercise, creating RecyclerView 
622-625 
RecyclerViews 
about 599-600 
adapter 
about 605 

adding interface to 634 
code for Captionedlmages Adapter 611 
creating 606 
creating constructor 609 
decoupling with interface 633 
keeping reusable 633 
ViewHolder for 607-610 
adding to layout 613 
arranging views 615-616 
creating 612 

fragment for 612-614, 617-618, 636-637 
implementing listener 636-637 
ListViewvs. 631 
responding to clicks 631-638 
summary of code 619-621 
support libraries for 602 
refining apps 3 1-37 
relative layout, as ViewGroup 204 
Relative Layout element 46-47 
RelativeLayout element, in activity_main.xml 33, 38 
relative layouts 
about 165 
adding padding 167 

displaying views in relative positions 166 
positioning views relative 
to other views 170-171 
to parent layout 168-169 
summary for creating 173 

using margins to add distance between views 172 
remove() method 301 
renaming tables, SQLite databases 466 
render thread 526 
replace() method 427 
requestFocus() method 203 
requestLocationUpdates() method 578 
Reset button 

attaching onClickListener to 35 1 
in nested fragment code 346-350 
in stopwatch app 120, 127 
in StopwatchFragment 336 



res folder 

in gradle projects 17 
in interactive apps 43 
resource files 
about 2 

in folder structure in Android Studio project 16 
Results parameter, AsyncTask defined by 530, 535 
right value 182,184 
R.java 17,59,65,111 
root folder, in gradle projects 17 
running app, in Android emulator 23-30 
runTimer() method 
creating 123 
in rotated device 131 
in stopwatch app 125, 129, 139, 148, 155 
updating stopwatch 121 

s 

Safari Books Online xxxiv 
Scroll View, as GUI component 219 
SDK (Software Development Kit) 5 
selectltemO method 411,414 
SELECT statements 477,492 
Service class 544,571,575,577 
service element 548 
Service Magnets exercises 
creating bound service 583-584 
creating started service 567-568 
services 
about 542 

bound. See bound services app 
started. See started services app 
setActionBarTitle() method 412, 426 
setAdapter() method 253 
setContentIntent() method 560 
setContentView() method 129, 249, 278-279, 356 
setDisplayHomeAsUpEnabledO method 393 
setDrawerListener() method 417 
setltemCheckedO method 426 
setOnClickListener() method 351 
setShareIntent() method 388 
setText() method 60 
setTransition() method 30 1 
setVisibility() method 203 
setWorkout() method 280 
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ShareActionProvider 388-389 
Sharpen your pencil 
calling custom Java class 67-68 
changing app to linear layout 187-188 
choosing type of thread for block of code to run on 
527-528 

converting code to fragment 328-331 
determining results of onCreate() method 453-454 
restoring state of activity in activity life cycle 145— 
146 

writing code for TopFragment 641 , 643 
shortcuts, app 366-367 
showAs Action attribute 378 
Sierra, Kathy Head First Java 4 
SimpleCursor Adapter 497 
Software Development Kit (SDK) 5 
sorting data, using queries for 480 
Spinner element 
about 48-49 
adding values to 53-54 
as GUI component 214 
attributes of 49 
spinners 

accessing methods with 60 
as type of view 202 
using AdapterView class with 25 1 
SQL functions, using in queries 481 
SQLite database. See also tables, SQLite 
about 437-439 
accessing other databases 440 
apps running slow on 
about 525-529, 539 

AsyncTask performing asynchronous tasks 530-539 
changing 455 

changing Starbuzz app to use 473 
code for DrinkActivity 474,490 
creating 472 

creating database 442-445 
creating tables 446-452 
CursorAdapters 
about 494 

closing database and 499 

mapping data using SimpleCursorAdapter to views 
497 

reading data 495-496 
cursors 



close database and 489 
code for getting 486 
get database data with cursor 475 
getting values 489 
navigating 487-488 
downgrading 461 
DrinkActivity. See DrinkActivity 
DrinkCategoryActivity 493-506 
Drink table 

adding new column 462, 465 
applying multiple conditions 450 
creating 447 
deleting 466 
deleting records 450 
inserting data 448 
renaming 466 
updating records 449 
getting reference to database 484-485 
JDBC and 440 
location of 439 
location of directory 440 
queries 
about 476 

applying conditions to 478-479 
creating 477 
sorting data in 480 
specifying conditions as Strings 479 
specifying table and columns 478 
using SQL functions in 481 
replacing array data in ListView 494 
SQLite helper decision tree on 459 
StarbuzzDatabaseHelper code 451-452 
structure of Starbuzz app 441-442 
upgrading 
about 457-460 

adding new table column 462, 465 
code for 467-469 
deleting tables 466 
existing database 465-469 
renaming tables 466 
usernames and passwords 440 
version numbers 456-461 
SQLiteDatabase class 
about 440 

accessing database using 447 
as subclass of object 448 
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query() method defined in 484 
SQLiteDatabase query () method All 
SQLiteExceptions 485,492 
SQLite helper 
about 437,443 
creating 444 

creating database 457-458 
decision tree 459 
for upgrading database 467-469 
onCreate() method 456-459 
StarbuzzDatabaseHelper code 45 1-452 
SQLite helper class 440,444 
SQLiteOpenHelper class 484 
SQLiteOpenHelper superclass 444-445, 460-461 
SQL (Structured Query Language) 
creating tables using 447 
functions 481 
GROUP BY clauses 482 
HAVING clauses 482 
SELECT statements 477,492 
using execSQL() commands 466 
src folder, in gradle projects 17 
StaggeredGrid LayoutManager 615 
Starbuzz app 
about building 232 
adding Drink class 236 
adding resources 235-237 
app structure and steps 234-235 
creating project 235 
DrinkActivity. See DrinkActivity 
DrinkCategoryActivity 493-506 
drink detail activity 
about 233 
code for 263-266 
creating DrinkActivity 235 
displaying data for single record 259 
in app structure 234 
launching DrinkActivity 265 
retrieving data from intent 260 
updating views with data 261-262 
drinks category activity 
about 232,247 
adding array adapter 252 
creating DrinkCategoryActivity 235, 249 
full code for 258 
in app structure 234 



responding to clicks with listener 256-257 
starting DrinkCategoryActivity 241, 257 
working with data 250 
Drink table 

applying multiple conditions 450 
creating 447 
deleting records 450 
inserting data 448 
updating records 449 
image files for 237 
navigating through 233 
SQLite database. See SQLite database 
top level activity 
about 232 

adding favorites to. See top level activity 
creating TopLevel Activity 235 
full code for 243-244 
in app structure 234 
layout contents 238,240 
responding to clicks with listener 241 , 244, 256 
set listener to ListView 242 
using wtih list views and spinners 25 1 
StarbuzzDatabaseHelper class 444 
startActivity() method 83, 99, 113, 117 
Start button 

attaching onClickListener to 351 
in nested fragment code 346-350 
in stopwatch app 119 
in StopwatchLragment 335-336 
started services app 
about 542 
creating 543 

displaying message in log 543-551 
about 543 
adding buttons 549 
ceatiing IntentService 544-545 
code for DelayedMessageService 547 
declaring services in AndroidManifest.xml 548 
logging messages 546 
starting service 550-551 
displaying message in notification 556-566 
about 543,556-557 
code for 562-566 
creating notification 558 
sending notification 561 
starting activity 559-560 
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displaying message in Toast 543, 552-555 
startService() method 550 
start value 184 
static data, array for 250 
Stop button 

attaching onClickListener to 351 
in nested fragment code 346-350 
in stopwatch app 120 
in StopwatchFragment 335-336 
stopwatch app 
about 118 
activity code of 121 
adding code for buttons 122 
building 118 

complete activity code 157 
converting code to fragment 328-334 
creating runTimer() method 123 
dealing with configuration changes 136-140 
formatting time on stopwatch app 127 
implementing onStopO method 144 
layout code for 119-120 
pausing and resuming 151-156 
reset 127 

restoring state of activity 147-149 
rotating device 131-132 
scheduling code 124-126 
working with activity code 121 
StopwatchFragment 

adding to WorkoutDetailFragment 337-343 
code for 332-334, 352-354 
error output for buttons in 345-346 
layout for 335-336 
onClick attribute and 347-348 
onClick() method 349-350 
onCreateView() method 351 
Strings 

datatype 489 

specifying conditions in queries as 479 
strings. xml 
adding 

chooser to 111 

code for ActionB arDrawerToggle 417 
code for TopFragment 401 
String resource to 508 

defining string-arrays 53-54, 65, 72, 239, 402-404, 
407 



in gradle projects 17 
in interactive apps 40,50, 50-51 
in multiple activities app 77 
in stopwatch app 120 
in StopwatchFragment 336 
putting string values in 34-35, 37 
setting default theme in 374 
static array in 250 
up close 36 

Structured Query Language (SQL) 
creating tables using 447 
functions 481 
GROUP BY clauses 482 
HAVING clauses 482 
SELECT statements 477,492 
style element, defining styles in 373 
SUM() functions 481 
superclass methods 144, 284-285, 290 
Swing 4 

Switch element, as GUI component 209 
syncState() method 421 

T 

tables, SQLite 
creating 446-452 
datatypes 446 
Drink table 

adding new column 462, 465 
applying multiple conditions 450 
creating 447 
deleting 466 
deleting records 450 
inserting data 448 
renaming 466 
updating records 449 
primary key columns in 446 
queries for 
about 477 

applying conditions to 478-479 
creating 477 
sorting data in 480 
specifying conditions as Strings 479 
specifying table and columns 478 
using SQL functions in 481 
StarbuzzDatabaseHelper code 451-452 
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using queries in 476 
tablets, device app layouts for 
about 306-307 

determining which layout device is using 320 
layouts for 314 

putting screen- specific resources in folders 
about 308 

different folder options 309 
running code 320-321 
TaskStackBuilder 559-560 
testing, apps 673 
text attribute 45,47,508 
TEXT data type 446 
TextView 

as GUI component 205 
as subclass of View class 202 
in activity_main.xml 33 
inCardview 609-610 
in PizzaDetailActivity 627 
in Relative Layout element 47-48 
updating 86-87 
TextView class 
about 45 

referencing 59-60 
setting text in 60 
text views 
about 45-46 
attributes of 49 
referencing 59-60 
theme attribute 372-373 
themes, action bar 
about 368 

AppCompat 370-371 
applying in AndroidManifest.xml 372 
customizing 373 
Holo 368,371,374,385 
Material 368,371,374,385 
modifying properties of 373 
using on different levels different 385 
threads 

code running on which 529 
main event 526 
render 526 
types of 526 

time on stopwatch app, formatting 127 
title attribute 377 



Toast element 
as GUI component 220 
displaying message in 543,552-555 
ToggleButton element, as GUI component 208 
TopFragment 
changing 639,644-646 
creating 401 
top level activity 
about 229 

adding favorites to 507-525 
about 508 

adding column to cursor 509 
code for 513-514 
displaying favorites in 515-521 
putting important information in 507 
refreshing cursors automatically 522-525 
updating database by responding to clicks 510 
creating 235 
full code for 243-244 
in app structure 234 
in building Starbuzz app 232 
layout contents 238,240 
navigating through 230 
Pizza app 
about 366-367 
changing top screen 639 
responding to clicks with listener 241 , 244, 256 
set listener to ListView 242 
structure of apps and 366-367 
top value 182,184 
tostring() method 275 
toString() method 253 

u 

unbindService() method 588,593 
Up button 391-394,420 
update() method 449,510,532 
updateMyDatabase() method 462 
USB debugging, enabling 105 
using Android action bar icon pack 379 

y 

v4 support library 369 
v7 appcompat library 369-371,378 
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